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PREFACE 



The purpose of this KRONOS 2. 1 Workshop Manual is to provide the system analyst with 
detailed internal documentation readily available in a single manual. However, before the 
information presented herein is of value as reference material, the analyst should attend 
the KRONOS 2. 1 Workshop. This workshop provides additional explanations for those areas 
which are not self-explanatory. 

To accomplish the above objective, the manual provides detailed descriptions of system 
routines, including system interfaces, tables, and flowcharts. Some user interfaces are 
mentioned, however, all interfaces are described in other existing KRONOS 2. 1 Manuals. 



Participants in the workshop should be familiar with KRONOS 2. 1 Time-Sharing and Usage, 
CP and PP COMPASS, and Operating Systems Theory. 

Reference materials required during the workshop include current listings and reference 
manuals. 

Current Listings 

1) Catalog of a KRONOS 2. 1 system 

2) Dump of CMR. (This may be obtained by using the 
absolute dump program listed in Section 27. ) 

3) SYSTEXT (PPCOM and CPCOM) 

Reference Manuals 



1) KRONOS 2. 1 Installation Handbook 

2) KRONOS 2. 1 Operator's Guide 

3) MODIFY Reference Manual 

4) KRONOS 2. i Reference Manual 

5) KRONOS 2. 1 Instant Manual 

6) KRONOS 2. 1 Transaction Subsystem 

7) COMPASS Reference Manual 



60407500 
60407700 
60281700 
60407000 
60407200 
60407900 
60360900 
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The following two charts summarize all the Tape handling control cards/macros. More in- 
formation is available in the Reference Manual, Section 5. 
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UNLOAD 
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*1 

*2 
*3 
*4 
*5 



Yes, if VSN specified on VSN card or VSN parameter on control card. 
Yes, if VSN not specified or duplicate VSNs are loaded on tape drives. 
If U parameter specified tape will not be unloaded, otherwise it will be. 
Label is only VOL1, HDR1. 

1. If R parameter specified, NOS checks tape labels against values on LABEL card, if comparison fails 
the Job is aborted. 

2. If W parameter specified, NOS checks tape labels against VSN on card, then writes labels from 
parameters on LABEL card. (See P. 5-93 Ref. Manual.) 

3. If the lfn previously exists when the LABEL or REQUEST card is encountered, the LABEL or REQUEST 
card is treated as a NOOP. 

If Demand count = assign count reduce Demand count by one. If Demand count < assign count, do not 
change Demand count. 
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( buffer 
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Tape Mark 
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*1 PRU =128 words for coded 
512 words for binary 

*2 for labeled tapes: TAPEMARK, EOF1 
for non-labeled tapes: None 
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KRONOS 2.1 INTRODUCTION 



1.0 SCOPE 

The KRONOS operating system controls the use of Control Data CYBER 70/Models 72, 73 
and 74, and 6000 Series computer systems. Therefore, KRONOS is in control of the com- 
puter. KRONOS accepts input in the form of jobs submitted by users and processes them as 
directed by control cards accompanying each job as well as by keyboard commands from 
the console operator. The KRONOS operating system accepts jobs in four ways: time- 
sharing, local batch, remote batch, and system console input (Figure 1-1). 

Efficient processing of user's jobs is the prime objective of the operating system. This 
section describes the inherent hardware characteristics, the basic software elements, and 
how they work together to accomplish the prime objective. Figure 1-2 shows the KRONOS 
system equipment configuration. 

1. 1 HARDWARE CHARACTERISTICS 

KRONOS uses Peripheral Processor Units (PPU) for system and input/ output tasks and a 
Central Processor(s) Unit (CPU) to execute user and system jobs. Central Memory (CM) 
contains user programs; system software areas are located at the lower end of Central 
Memory, Extended Core Storage (ECS) may be used by KRONOS. 

1.1.1 Central Processor Unit 1 

The CPU is designed to perform tasks of a computational nature; it has no input/output 
capability. It communicates with other system components through the central memory. 
Under KRONOS, the CPU is used almost exclusively for program compilations, assemblies, 
and executions. The CPU makes system requests through a CPU request register located 
at the Reference Address plus one (RA+1) of the current program in execution. However, 
that system work which can be done better in the CPU, is also processed in the CPU. 



1. 1.2 Peripheral Processor Units 

The peripheral processor units from 1 to 20 (identified as PP0, PP1, . . . PPn) are identi- 
cal; they perform many tasks for requesting programs in central memory. Peripheral 
processor unit(s) commonly referred to as PP(s) shall be so identified throughout this docu- 
ment. Each PP consists of PP memory of 4K, 12-bit, 1-byte words. 



I 
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Figure 1-1. KRONOS System Equipment Configuration 
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Figure 1-2. Typical Hardware Configuration 
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A PP can be assigned to control input/output, job scheduling, control card interpreting, 
system housekeeping and other tasks as required. Tasks are assigned one at a time to 
each PP by the CPU system monitor (CPUMTR). When an assigned task is completed, the 
PP signals the system. CPUMTR waits for this signal before assigning another task to the 
PP. 

Each PP is assigned a block of eight words in the system area of central memory through 
which communications with the system are conducted. Each block contains an input regis- 
ter, an output register, and a message buffer. 

| 1. 1. 3 Central Memory 

Central memory words are 60 bits long; each is composed of five 12 -bit bytes. Each 12- 
bit byte in a CM word is numbered through 4, from left to right: 



59 



48 47 



36 35 



24 23 



12 11 



byte 



byte 1 



byte 2 



byte 3 



byte 4 



One or more user programs may be in some state of execution concurrently under KRONOS. 
These programs are stored in central memory in an assigned user area; a set of system 
components necessary for the operation of the system is also stored in central memory, 
forming Central Memory Resident (CMR). Central memory is accessible by all PP's and 
CPU(s) and forms the communications link between all processor units in the computer 
system. 

CMR contains system communications areas, system tables, CPU resident routines, the 
library directory, and information about each job currently in execution. 

I. 2 EXTENDED CORE STORAGE 

Under KRONOS 2. 1, Extended Core Storage (ECS) may be used as a high-speed peripheral 
storage device via a TRT (Track Reservation Table). 

1. 3 SOFTWARE ELEMENTS 

Two elements are basic to the KRONOS operating system: files and control points. 

| 1.3.1 Files 

A file is an organized collection of data known to the system by a given name. Data is 
organized in one or more logical records and terminated by an End-of-Information (EOI) 
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and final results are contained in files or parts of files. 
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1.3.2 Control Points | 

The system can control execution of several jobs at one time. When placed into CM before 
execution, each job is assigned a value which is the control point number and the index to a 
control point. Jobs at control points are assigned to a processor for execution. Each con- I 
trol point area in CME holds all information necessary to process the assigned job. " 

1.4 KRONOS ORGANIZATION 

The KRONOS operating system consists of PP programs, CPU programs, macro definitions 
and symbol definitions. The entire system is contained in a magnetic tape file produced 
by the library maintenance program MODIFY. Programs in the library file are in source 
language form. Installation options are provided to permit flexible selection of system 
features during the assembly and creation of a deadstart file on tape. 

A system monitor is in complete supervisory control of the hardware system. The system 
monitor is made up of PP overlay MTR which operates in PPO, and CPUMTR which is I 

assembled as part of the central memory resident (CMR) . ' 



1 . 5 CENTRAL PROCESSOR AND KRONOS 

1.5.1 CM Organization 

The allocation of central memory is illustrated in Figure 1-3. 



Low Core 
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CM Librarv 



Assigned to 
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Figure 1-3. Central Memory Organization 

Low core is allocated to the central memory resident portion of KRONOS and executable 
system programs. The remaining area can be assigned to control points. 
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1. 5. 2 Control Point Concept 

Blocks of central memory storage not allocated for system use are ordered by control 
point number and assigned to jobs. Each control point number has a corresponding table in 
CMR called the control point area. A control point is not a physical entity, but rather a 
concept used to facilitate bookkeeping. The control point number and the control point 
area, however, are physical quantities that do appear in the system. 

Under KRONOS 2. 1 any number of control points, up to 23D (decimal) are possible. In 
the released system, the default value is 23 decimal. In an installation with n control 
points for user jobs they are numbered from 1 to n. A job assigned to a control point is 
identified by its control point number; only one job can be assigned to a control point at 
any one time. Once a job is assigned to a control point, system resources such as central 
memory, channels, equipments and processors maybe assigned to the control point for 
use by the job. 

Storage assigned to a single control point is contiguous; storage for all control points is 
not necessarily contiguous. The core storage block assigned to the job at control point 2 
is higher than the block for the job at control point 1, and storage for control point 3 is 
always higher than that for control point 2, and so on. 

In Figure 1-4, no storage is assigned to control points 3 and 5; unassigned storage appears 
between assigned storage. 
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Figure 1-4. Control Points in Central Memory 
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1.5.3 Sub Control Points 

Sub Control Points (SCP) is another concept of Control Data software. A SCP runs exactly 
the same way as a Control Point (CP) except that it is contained within one CP. The user 
writes a controlling segment, an Executive (much like a user-oriented CPUMTR), which 
via CPUMTR RA^l type requests can control a number of SCPs at its CP. The major use 

1.5.4 Special Control Points 

In addition to the n control points used for running jobs, control point n-1 and a pseudo 
control point numbered zero are used by the system. 

Control point zero is used to identify system resources not allocated to a job at a control 
point; they are deallocated or allocated to the system. If an equipment is assigned to a 
control point, that number is entered into the system table entry for that equipment. 

If not assigned to a job, the equipment is assigned to control point zero and is available 
to be assigned to a job. All active system files are attached to control point zero. They 
include the system file, any job files that have been read in and are waiting for scheduling, 
and all output files waiting to be processed by BATCHIO. Control point n-f 1 is used by 
CPUMTR to process certain CPUMTR functions. Any CPUMTR function which uses more 
than some preset amount of CPU time is assigned to the system control point n + 1 by 
CPUMTR. The system control point is treated as any other control point by the system 
with the exception that its queue priority is so high, it can never be rolled out. Its CPU 
priority is the highest in the system (100). 

1. 5. 5 Job Description Number (FNT queues ordinal) 

During the course of execution, a job might not remain continuously at the same control 
point. It is possible for the job to be rolled out while it is only partially executed. When 
a job is rolled out, it is not associated with a control point. When a job is rolled back in, 
it is probably associated with a control point other than the control point during its original 

assignment. 

During the time a job is rolled out, the only table in CMR that contains information about 
the job is the FNT with type rollout. 

1.5.6 Storage Moves 

Since jobs come and go as they finish processing and new jobs begin, or as jobs are 
rolled in and out, CM storage must be reallocated and jobs must be moved. If a job at 
a control point requests additional storage, it may be necessary to move jobs to obtain 
the required storage. 
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A request for a reduced field length merely resets the FL {field length) size in the control 
point area; no storage move takes place. A request for an increased field length, when 
the total already associated with the control point is adequate, will result in resetting the 
FL size in the control point area; no storage move will take place , 

If it is necessary to take unallocated storage from other control points to satisfy a request 
for increased field length, control points above and below the requesting control point will 
be scanned. This scan locates the combination of unallocated storage blocks which will 
result in a move of the least amount of storage. 

In Figure 1-4 shown under Control Point Concept, if control point 1, needs more storage, 
it will be necessary to move control point 2. If control point 6 needs storage, sufficient 
unallocated storage may be available to make a control point move unnecessary. If, 
however, control point 7 needs additional storage, control points 4, 6 and 7 will be moved 
downward to provide the storage. Added storage always extends the field length upward. 

I 1. 5. 7 CP System Communication 

A running CP program must communicate with the system as described in the following 

examples: 

1 . When a CP program is loaded and executed as a result of a control card 
call, the system must place any parameters specified on the control card 
in an area where they can be read by the CP program. 

2 No CP instructions allow a CP program to perform input/ output; therefore 
a CP must send a request to the system, to load a PP program to execute 
the input/ output. 

3. When a CP program terminates, it must advise the system that it may process 
the next control card. 

Since a CP program cannot access memory locations outside its field length, any area reserved 
for communication between a CP program and the system must be within the field length 
of the job. The first lOOB(octal) locations of each job's field length are reserved for this 
purpose. The first program loaded into a user field length is always loaded at location 
RA-100 (for the user, this is location 100). The RA area is shown in CMR Section 2. 
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1. 5. 8 CP PP Communication 

If a CP program wishes to call a PP program it places the PP programs name and up to 
two arguments in RA+1. If Auto-recall is desired bit 40 is set. If the Central Exchange 
Jump (CEJ) installation is available, the user's program should use it immediately after 
placing a call in RA+1. This will cause CPUMTR to begin execution immediately. If 
CPUMTR determines that the RA + 1 call should be assigned to a PP, CPUMTR will write 
the RA+1 word into the PP's in^ut register in CMR. The name and an w parameters in 
bits zero through 35 appear in the input register exactly as they did in RA+1. Parameters 
are passed from a CP program to a PP program through this parameter field. The format 
for the PP communication area is shown in CMR Section 2. 

For example, if the PP program CIO is called, CIO will find the relative address of the 
File Environment Table (FET) to be used in the operation by reading its input register. It 
can find the RA of the control point field length by reading the control point number from 
its input register, computing the address of the control point area, and reading the value 
of RA from the control point area. By adding the RA to the relative FET address, CIO 
obtains the absolute address of the start of the FET. CIO then reads the parameters 
for the I/O operation from the FET. 

MTR continually scans RA+1, in the event that the users program does not use the central 
exchange jump, or the instruction is not available. When a RA^l call is found, MTR 
initiates CPUMTR. Less CPU time is used by letting CPUMTR process the call, than 
if MTR did it directly. 

1. 5. 9 Program Recall 

The recall program status is provided in KRONOS to enable efficient use of the central 
processor and to capitalize on the multiprogramming capability of KRONOS. Often, a 
CP program must wait for an I/O operation to be completed before more computation 
can be performed. To eliminate the CPU time wasted if the CP program were placed in a 
loop to await I/O completion, a CP program can ask KRONOS to put the control point 
into recall status until a later time; the CPU may be assigned to execute a program at 
some other control point. 
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Recall may be automatic or periodic. Auto-recall should be used when a program requests 
I/O or other system action and cannot proceed until the request is completed. KRONOS will 
not return control until the specific request has been satisfied. Periodic recall can be 
used -when the program is waiting for any one of several requests to be completed. The 
program will be activated periodically, so that it can determine which request has been 
satisfied and whether or not it can proceed. 

1.5.10 Periodic Recall 

To enter periodic recall, a CP program puts the characters RCL left-justified into RA+1. 
On encountering the RCL request, the system assigns the CPU to some other control point. 
After a certain interval of time has elapsed, the control point is restarted and the CPU is 
again assigned to execute the program at the control point. At this time, the CP program 
can check the completion bit in the FET to see if the I/O is finished. If so, the CP program 
may proceed with computations. If I/O is not complete, the CP program can put itself back into 
recall. 

1.5.11 Automatic 'Recall 

If a CP program makes a request in RA+1 and bit 40 of RA + 1 is set to one, the control 
point will be put into automatic recall after the request has been initiated. Again, the 
CPU is assigned to another control point as in periodic recall. In this case, however, 
the program in recall will be restarted by CPUMTR after the PP has dropped or issued the RCPM 
functions. The completion bit in the FET is never statused. The only criterion for CP start-up 
is the RCPM or drop. 

Recall and auto-recall are most often used while waiting for CIO to process an I/O request; 
however, any time a PP program is called from RA+1, with bit 40 of RA+1 set to one, the 
control point will be put into auto-recall. If bit 40 is set, bits zero through 17 of RA+1 
must contain the address of a word in the program's field length called a reply word. 
When the PP has completed its function, it will set the completion bit (low order bit) in the 
reply word, and drop or RCPM. The completion has no basic significance to NOS. 

For a call to CIO, the reply word is the first word of an FET. For other programs the reply 
word need not be part of an FET. 

A CP program can put itself into auto-recall without calling a PP program by putting RCL 
left-Justified in RA+1 and setting bit 40 of RA+1 to one. Bits zero through 17 of RA+1 
must contain the address of a reply word. A program which has already initiated one or 
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more I/O operations might go into auto-recall in this way, using the first word of the FET 
associated with one of the I/O operations as the reply word. Figure 1-5 shows the 
formats of RA+1 for: a normal CIO call; a request for periodic auto-recall; a CIO call with 
auto-recall bit set; and an RCL call with auto-recall bit set. For periodic recall, a 
user must issue a normal CIO call followed by an RCL request. For auto- recall, only 
one request is required. 

CIO CALL 
59 42 40 17 

RA + 1 



RA+1 



CIO 







Count for 
Positioning Requests 


FET Address 



DISPLAY CODE (CIO=031117B) 

CIO CALL WITH AUTO-RECALL 
59 42 40 17 



CIO 



Count for 
Positioning Requests 



T 



FET Address 



RA+1 



59 



REQUEST FOR PERIODIC RECALL 

42 



RCL 





59 



RA+1 



REQUEST FOR AUTO-RECALL 
42 40 17 



RCL 




1 




Pseudo 
FET Address 



Figure 1-5. RA+1 CIO and Requests Calls 

SPECIAL NOTE TO PP PROGRAMMERS 

Any CP program making a call to a PP program using auto-recall needs to be restarted 
by the PP program unless the PP program intends to drop before the CP program is 
started up. Just setting the completion bit in the pseudo FET word is not enough to get 
the CP program restarted. In addition, the PP routine must issue the monitor function 
RCPM, request CPU, to get the CP program restarted. See Section 23 routine TLP for an 
example of the above . Also note that unless a CP program has QP > MXPS, all call to PP 
programs with the exception of CIO will be forced into auto-recall by CPUMTR. 
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XXX 
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1. a. RCPM or 
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Thus a user can be in Auto-Recall without PP activity. 

Remember all calls are put into Auto-Recall automatically-except CIO, or RCL. 

For the user there is no difference between user's set and system forced onto recall. 

Auto-recall initiated by the RECALL macro is treated as follows: CPU monitor checks the 
completion bit and if set takes the CP out of auto-recall. If not set, CPU monitor leaves the 
RCLP in RA+1 and exits. This request will be detected later by MTR, who will call CPUMTR. 

Normally, CP programs use auto-recall for convenience, but only one request involving 
auot -recall can be processed at one time. For example, to initiate I/O action on several 
files at once, a user must employ the periodic recall tecnique. He will issue all the 
requests without recall (using a separate FET for each request); then go into periodic 
recall. Each time the CP program is restarted by the system, it can check all the files 
for completion and go back into periodic recall if any are still incomplete. 

Periodic recall may be used also when a CP program can initiate an I/O request and then 
perform some computation. In some cases, the I/O would be completed before the computation; 
in others, the computation would be done first. The user would go into recall only when 
computation was done, and then only if the I/O was still in process. 

Periodic recall should also be used, if possible, to continue processing while only part of 
the data buffer has been read or written by the I/O driver. 

During normal operation central memory queue priority and CPU priorities are as shown 
in Figure 1-6. KRONOS supports 23D Control Points. Queue priority governs which jobs 
in the Input Queue gain access to CPs. CPU priority governs which jobs at CPs gain 
access to the CPU. 
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Figure 1-6. Central Memory Priorities 
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The following definitions are used extensively in KRONOS 2.1. A graph of CPU or CM time 
slice is provided to graphically point out the difference between these two very basic 
concepts . 

TABLE 1-1. SYSTEM RESOURCE TIMES 



ITEM 


DESCRIPTION 


Queue priority 


The priority which governs entry into a CP from the 
INPUT or ROLLOUT queue and also governs disposition 




to a printer. 


CPU priority 


The priority which governs which candidate for the 
CPU will get access to the CPU. 


CPU time slot 


That time period when the CPU is shifted from one 
candidate to another. 


CPU time slice 


The total time period that a CP can use the CPU 
without being penalized.* 


CM time slice 


The total time period a CP can reside in a CP 
without being penalized.* 



*The queue priority in CPA is reduced to the LQP for this orign type. 





TABLE 1-2. 


JOB ORIGINS 


SOURCE 


END 


SYOT 




SYSTEM 


BCOT 




BATCH 


EIOT 




EXPORT 


TXOT 




TELEX 


MTOT 




MULTI -TERMINAL 
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The CM time - increases linearly with time as long as the job is at a CP without 
respect to the use of the CPU. 

The CPU time - increases as a step function with a linear ratio only while the job 
is actually using the CPU. 



Figure 1-7. Graph of CM Time Slice and CPU Time Slice 



CENTRAL MEMORY RESIDENT 



2.0 INTitOuUC iiON 



The low end of central memory is reserved by the KRONOS operating system and provides 
the major coordinating area for system operation. Central Memory Resident (CMR) 
contains pointers, tables, central monitor (CPUMTR), libraries, and library directories. 
The length of CMR is dependent upon several factors, including the number of peripheral 
processors, the number of control points, the number of mass storage devices, and 
others. Figure 2-1 shows an overview of the layout of CMR giving the relative positions 
of the various parts of CMR. Subsequent discussions describe in more detail the many 
pointers and tables resident in CMR. 
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AND 
TRACK RESERVATION 
TABLES (TRT) 



JOB CONTROL AREA 



DAYFILE BUFFERS 



DAYFILE DUMP BUFFER 



ECS/PP BUFFER 



CPUMTR 



(RPL) RESIDENT PERIPHER- 
AL LIBRARY 



(RCL) RESIDENT CENTRAL 
LIBRARY 



(PLD) PERIPHERAL LI- 
BRARY DIRECTORY 



(CLD) CENTRAL LIBRARY 
DIRECTORY 



AVAILABLE CORE 



200B words for each control point 



3 entries for the three system dayfiles 
(SYSTEM, ERR LOG, ACCOUNT) + 1 entry 
for each control point; 2 words for each 
entry 

10B words for each PPU 

1 word entry for each type of 
equipment, 100 words total 

2 word entry for each file active in 
the system 

MST consists of MSTL (currently = 20B) 
words for each mass storage device. 

TRT immediately follows the MST for each 
device and is size dependent on device. 



All buffers for all CPs and the 3 system 
dayfile buffers 100B words per buffer 

Used by (1DD) dayfile dump routine 
called from DFM when dumping dayfiles. 
Only one PPU can dump dayfiles at a time. 

Used to transfer ECS words to PP memory 
or other ECS locations. It is 100B words 
long to ensure that CM is not locked out and 
that the read pyramid is not tied up. In 
this way critical PP routines like 1TD, 1MT, 
DSD are not locked out of CM and miss 
data scans . 



Figure 2-1. CMR Layout 
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TABLE 2-1. FNT/rST MASS STORAGE FILE TYPES 



FILE TYPES 


VALUE 


DESCRIPTIONS 




Files in Queues 




INFT 





INPUT 


ROFT 


1 


ROLLOUT 


PRFT 


2 


PRINT 


PKFT 




nTTMr<TT 


TEFT 


4 


TIMED/EVENT ROLLOUT 


QUFT*1 


5 
Other Files 


END OF FILE IN QUEUES 


SYFT 


5 


SYSTEM 


LOFT 


6 


LOCAL 


CMFT 


7 


COMMON 


'LIFT 


10 


LIBRARY 


PTFT 


11. 


PRIMARY TERMINAL 


PMFT 


12 


DIRECT ACCESS PERMANENT FILE 


FAFT 


13 
Cyberlink Files 


FAST ATTACH FILE 


HSFT 


14 


CYBERLINK TRANSMIT 


LCFT 


15 


WAIT USER ACCESS FILE i 


CNFT 


16 


IN CYBERNET FILE ! 


MXFT * 2 


17 


MAXIMUM NUMBER OF FILE TYPES '. 

| 



* 1 Used by the system as an upper limit for checking of types (i.e., all types 
less thanQUFT are type QUEUE. 

*2 See * 1 (i.e., any types greater or equal MXFT are illegal). 
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TABLE 2-2. NON FNT/FST TYPES 



TYPE 


VALUE 


DESCRIPTIONS 


SYOT 

BCOT 

EIOT 

TXOT 

MTOT 

MXOT * 1 


Job Origin 



1 
2 
3 

4 

5 


SYSTEM 

BATCH 

E/I 200 

TELEX 

MULTI TERMINAL 

MAXIMUM JOB ORIGIN TYPE 


TLET 
ARET 
PPET 
CPET 
PCET 
ODET 
PSET 
FLET 
TKET 
SYET 

MXET*2 


Error Flags 

1 

2 

3 

4 

5 

6 

7 
10 
11 
12 

13 


TIME LIMIT 
ARITHMETIC ERROR 
PPU ABORT 
CPU ABORT 
PP CALL ERROR 
OPERATOR DROP 
PROGRAM STOP 
FILE LIMIT 
TRACK LIMIT 
SYSTEM ABORT 

MAXIMUM NUMBER OF ERROR FLAGS 


FECT *3 
FNCT 

EBCT 


Pseudo Channels 

14 
15 

16 


CREATE NEW FNT EN-TRY 
FILE ENTRY PSEUDO CHANNEL 
FILE NAME TABLE UPDATE EXISTING 
FNT ENTRY 

ECS BUFFER 



* 1 See * 1 p. 2-1 (i.e., all job origin types must be less than MXOT). 

* 2 See * 1 p. 2-1 (i. e., error flags greater or equal MXET are illegal). 

* 3 The two pseudo channels FECT and FNCT can be redescribed as follows: 

.FECT create new FNT entry. FNT entries are denoted as empty when the lfn equals 
zero. OBF, with the exception of 1TA for TELEX, is the only routine which creates 
new FNT entries. In order to protect from two OBFs attempting to create new files 
in the same FNT entry, this pseudo channel is used. When OBF decides where to 
create its entry, it requests this pseudo channel. Then it can enter the file with 
no fear of some other OBF simultaneously trying to use the same entry. 

FNCT update existing files. Primarily used by CIO to update the status and 
position information in the FST. 

The pseudo channel EBCT is used to interlock the ECS/PP buffer in CMR. 
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TABLE 2-3. FIXED SYSTEM PRIORITIES 



NAME 


VALUE 


DESCRIPTIONS 


MXPS* 


7760 


MAXIMUM PRIORITY FOR ROLLOUT 


CLPS 


7765 


CYBERLINK 


MSPS 


7766 


MASS STORAGE CONTROL 


STPT 


7767 


TRANSACTION STIMULATOR 


STPS 


7770 


TELEX STIMULATOR 


TRPS 


7771 


TRANEX 


MTPS 


7772 


MAGNET 


BIPS 


7773 


BATCHIO 


EIPS 


7774 


E/I 200 


TXPS 


7775 


TELEX 


MNPS 


100 


MINIMUM SCHEDUABLE 


FRPS 


1 


FORCED ROLLOUT 


ERPS 


2 


JOB ERROR 


FEPS 


3 


FORCED ROLLOUT, NO FL 


FFPS 


4 


FORCED ROLLOUT, WITH FL 

j 

i 



* Priorities above MXPS are used by subsystems for identification as well as 
scheduler control. 

The following is true for QP of MXPS: 

1. QP < MXPS: job can be rolled out and can be penalized for exceeding its time 
slices. 

2. QP = MXPS: job can only be rolled out by subsystems and is not penalized for 
exceeding its time slices . 

3. QP >MXPS: job can not be rolled out, and is not penalized for exceeding its 
time slices. 

Jobs which are rolled in by operator action or waiting for operator tape assignment are 
given QP - MXPS . 
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TABLE 2-4. POINTERS AND CONSTANTS -ALPHABETICAL LIST OF NAMES 



NAME 


VALUE 


DESCRIPTIONS 




System Constants 


CHDS 


10 


Display Channel 


CHMT 


13 


Magnetic Tape Channel 


DFDS 


230 


Dayfile Dump buffer length 


MPRS 


100 


Monitor function priority 


NMSD 


20 


Maximum number of Mass Storage 
devices 


NPFS 


4 


Number of P.F. activities allowed 


NROS 


2 


Number of simultaneous Rollout/ Rollin 




Pointers 




ACML 


23 


Available central memory 


ACPL 


60 


Active CPU status 


CLD 


25 


Central Library Directory 


CLDP 


7 


CLD Pointer 


CMCL 


57 


Central Memory control image (MTR) 


CPUL 


1 


CPU configuration 


CTIL 


100 


Channel Status Table 


DFPP 


3 


Dayfile pointer 


DTEL 


31 


Date (DSD) 


ESTP 


5 


EST Pointer 


FNTP 


4 


FNT Pointer 


IPRL 


42 


Installation parameters 


JBCP 


4 


Job Control Area pointer 


JDAL 


26 


Julian date 


JSCL 


40 


Job Scheduler Control 


JSNL 


22 


Job Sequence Number 


MFLL 


1 


Machine field length 


MSAL 


107 


Mass Storage fill assignment 
(entry = 4000B + equipment number) 


MSCL 


24 


Monitor scan control 


NCPL 


2 


Number of Control Points 


PDTL 


27 


Packed date 


PFNL 


110 


P.F. activity control 


PLD 


24 


FWA of Peripheral Library directory 


PLDP 


2 


PLD pointer 


PFAL 


47 


IR address of next available PPU 


PPCP 


2 


PP Communication area pointer 


PPUL 


1 


PP Configuration 


PXPP 


62 


PP Exchange area pointer 


PCLP 


6 


Resident CPU Library pointer 


RPLP 


1 


Resident PPU Library pointer 


RTCL 


106 


Real Time Clock image (MTR) 


SFPL 


64 


* SFP * auto load code 


SPLP 


46 


System PLD pointer 


SSCL 


44 


Sub-System Control words (C.P. numbers) 


SSTL 


43 


System Status 


TIML 


30 


Time of Day (DSD) 
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TABLE 2-5. CONTROL POINT AREA - ALPHABETICAL LIST OF NAMES 



NAME 


N*200 +VALUE 


1 

DESCRIPTION \ 


AACW 


75 


i 
Account access control word ! 


ACTW 


50 


Start of accounting words 


ACTWE 


54 


End of accounting words 


ACTWL 


-- 


Length of accounting words 


ACUW 


74 


Account Central memory usage 


A O TITf 


TO 


A ****,.. .«l —« n ^ n *>J- — ... U~-~ -%«-] 


Hi <j yv 


■ Sj 


rw,*~*j\n.i.\, jji^"jcv.s, nuuiuci wui u 


APUW 


73 


Account peripheral usage word 


CMUM 


51 


Central memory usage 


CPJW 


54 


Central processor time start of job 
(TXOT only) 


CPNS 


- 


First control point number 


CPTW 


50 


Central processor time 


CSBW 


130 


Control Statement buffer 


CSBWE 


200 


End of Control statement buffer 


CSPW 


67 


Control statement pointer 


CTLW 


24 


CPU time limit 


DBAW 


66 


K and L Display control word i 


EECW 


65 


ENTRY/EXIT Control j 


FLCW 


60 


Field length control 


ICAW 


76 


Inter- control point communication , 
control 


JCIW 


22 


Job Control information 


JCRW 


102 


Job Control registers ; 


JNMW 


21 


Job Name | 


LDCW 


61 


Loader Control word 


MSUW 


52 


Mass storage usage 


MS1W 


30 


Message 1 area 


MS2W 


35 


Message 2 area 


MTUW 


53 


Magnetic tape usage 


OAEW 


21 


Operator assigned equipment ! 


PFCW 


63 


Permanent file control word j 


RFCW 


71 


Resource file control word j 


RLPW 


25 


PP recall register 


SEPW 


100 


Special Entry point Word 


SNSW 


26 


Sense switches 


SPCW 


101 


System processor call word 


STSW 


20 


Status word 


TIAN 


62 


Terminal interrupt address 


TINW 


65 


Terminal input pointer 


TIOW 


62 


Terminal I/O pointers 


TSCW 


23 


Time Slice Control 


UIDW 


64 


User identification 


UPCW 


77 


User profile Control word j 
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TABLE 2-6. REMAINING CENTRAL MEMORY - ALPHABETICAL LIST OF NAMES 



NAME 


OFFSET VALUE 


DESCRIPTION 


CLD 


25 


CLD - CPU Library directory 
Entry = 2 words. 


DEVL 


4 


Device allocation information 


DFBP 





Dayfile buffer pointers. 
Entry = 2 words. 


EST 





Equipment status table. 
Entry = 1 word 


ETB 


1 


System event tag 


FNT 





File name table . 
Entry = 2 words. 


INQT 





Input file control 


ISTL 


15 


Installation use 


JBC 


41 


Job control area 


MSDL 


1 


Mass storage driver mods 


MST 





Mass storage table 


MSTL 




Length of MST 


MXQT 


3 


Maximum number of queue control 
words 


OTQT 


2 


Output file control 


PFCT 


5 


Permanent file control 


PFDL 


6 


Permanent file description 


PFIL 


5 


Permanent file interlock word 


PFUL 


7 


Permanent file user description 


PLD 


24 


PPU library directory 


PPC 


202 


PPU communication area 


RCL 


21 


Resident CPU library 


ROQT 


1 


Rollout file control 


RPL 


23 


Resident PPU library 


SVJT 


3 


Service control 


TRT 


20 


TRT - Track Reservation Table. 
Entry = 1 byte -f 1 bit for each track . 


TRTL 





TRT^definition 
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uuu 

001 

002 
003 
004 
005 
006 

007 

010 

017 
020 

021 
022 

023 

024 

025 
026 
027 
030 
031 
032 

037 

040 

041 
042 

043 

044 

045 

046 
047 



HS 


47 


35 


29 


23 


11 




Zeros 


| 


FWA Resident PP 
Library 


Number 
of PPUs 


*1 CPU 
Conf ig . 


Machine FL 


FWA PP library 
Directory 




Number of 
CTRL PTS 


PP Comm. 
Area Addr 


Dayfile 
PNTR FWA 


FWA Dayfile 
DUMP Buffer 




No, Exces *6 
Dayfiles 


FWA 

FNT 


LWA+1 
FNT 




FWA Job Control Area 


FWA 
EST 


LWA+1 
EST 


LWA+1 RMS 

Equipment 


FWA ECS/PP Buffer 


FWA 

CPU Library 




FWA CPU Library 
Directorv 


FWA COS Format 
CPU Lib Directorv 


Installation Area 




CMR bize/ j 
100B j 


System Name ■ 


1 


Job Sequence Number ] 
Counter 

! '' 



Job 
Scheduler 



CPU 
Recall 



PP/Auto 
Recall 



Avail CM 
/ 100 B 



Job 
Advance 



Job 
Switch 



Reserved 



HH.MM.SS. 



Julian Date 



Year Mo | Day| Hrs 



Min 



Sec 



YY/MM/DD. 



System Date Line 



Bit 12 is Scheduler 
Requested Flag 



Bit 59 is Scheduler 
Active Flag 



18 bits 
*3 



Assumed 
Char. Set 
Conversn. 



Scheduler 
Cycle 



18 bits 
*4 



Assumed 
Conver. 

Mode 



Assumed 
Tape Den 



*2 See Footnote 



Reserved 



TRANEX 



TELEX 



TELEX 
Stim. 



Pointer to Non Alter- 
nate Device PLD 



E/I200 



TRANEX 
Stim. 



BATCHIO 



Reserved 



No. CNTL 
PTS 



Descriptions follow: 

Figure 2-2. 



MAGNET 



CYBER- 

LINK 



Addr. PP 
Comm. Area 



IR Addr. Next 
Avail PP 



Pointers, Constants, and Control Words 



RPLP, PPUL, 
CPUL, MFLL 

PLDP.NCPL, 

ppcp' 

DFPP I 
FNTP, JBCP 
ESTP *5 | 
RCLP 
CLDP 



JSNL 

ACML 

MSCL 
(Delay Word 

JDAL 
PDTL 
TIML 
DTEL 



JSCL 



IPRL 



SSTL 
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SSCL (Subsystem 
Control Words) 



SPLP 

PPAL if 0, No 

PP is Available 

2-9 



* 1 Bit 15 CMU Present 

14 CEJ/MEJ Option Present 

13 CPU 0=6600 Present 

12 CPU 1 = 6400 Present 

* 2 Bit 0-Disable Autoroll, 1-Disable Job Scheduler, 2-Disable Priority 

Eval, 12-Debug Switch, 13-Console Init.Lock Status 

42-Disable Removable Device Checking, 43-Disable Tranex,4 4-Disable 
Magnet-45-Disable EI200, 46-Disable Telex, 47-Disable BATCfflO, 
48-Disable Acct. Verification, 49-Ignore Acct. Card. 

* 3 Delay for 1SJ to call ISP 
*4 Delay for ISP to call 1CK 

* 5 Mass storage equipment can be mixed with non mass storage equipment in 

the 1st with the following restrictions: 

1. Eq must be MS if defined. 

2 . No MS may be specified beyond the CMR pointer for LWA + 1 of MS in 
word 5 (ESTP). (i.e. , the operator may not dynamically set any MS 
devices after this pointer in CMR with memory entry commands.) 

The system builds this pointer when the EST is created at D/S time. 

*6 Number of dayfile, besides CP. So normally = 3 for 3 system dayfiles. 



Figure 2-2. Pointers, Constants, and Control Words (Continued) 
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Used 

by 

CPU- 

MTR 



050 

051 

056 
057 



'beo 



061 
062 
063 
064 
065 

066 

077 
100 
101 
102 

103 

104 
105 

106. 
107 

110 

111 

112 
177 



59 




47 


35 


23 




11 


Idle Accumulation for CPUO and .CPXJI 


Reserved 


CNTL PT 
For Move 


Internal to MTR 


*i 




CPU CNTL 
PT Assig 


CPUO Exchange Address 


*2 




CP1 CNTL 
PT Assig 


CPU1 Exchange Address 




Address of PP1 
Exchanee Package 





(P) 

=PPR 


(A0) = 


(B0) = 


CRM (LA), 
6170 


ON 

1073 


LJM (LA) 
0100 


1073 


CON 7773B 
7773 


PSN 
0000 


LCD RPLA 
(RPL Addr) 

201 RPLA 


CRM (LA), CM+3 
6613 1073 


Reserved 


CHO * 3 


CHI 


CH2 


CH3 


CH4 


CH5 


CH6 


CH7 


CH10 j CHil 


CH12 


CH13 


CH14 FECT 
Unused 


CH15 i CH16 ! 
FNCT : FBCT 


■ CH17 
|_ Unused 


CH20 


CH21 


CH22 : CH23 

i t 


; CH24 


CH25 


CH26 CH27 • CH30 


j CH31 


CH32 


CH33 | CH34 j CH35 j 
: Unused Unused 


Seconds 


Milliseconds 


Scratch 


Input 


Output 


Rollout j LGO 


Permanent File Activity Control * 4 




Next time 
to acti- 
vate * 6 




Reserved 



* 1 CPU Off Flag (Bit 59) 

* 2 CPU 1 Off Flag (Bit 59) 

* 3 Channel Status 



Descriptions follow: 



Bit 11, on Indicates Channel Requested 

Bit 7-10, Unused 

Bit 6, On, Channel Not Available 

Bit 0-5, PP Assigned 



CMCL 
ACPL 



PXPP 

* 5 

SFPL "SFP" . 
Load Code 

Used to Find 1 Auto 



scope type * oa cl 
Fs^ pW 163 ' 



section) 

CTIL 

* 7 






RTCL 

MSAL RMS 
Storage Assign 

PFNL 

Removable de- 
vice system 
control 1 

*8 

Used to designate 
designate 
specific devices 
for these files. 
If overflow, use 
any TEMP types 
device. If 
active bit 1 1 
on & est ord 
in lower 6 bits . 



Figure 2-2. Pointers, Constants, and Control Words (Continued; 
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*4 Bit 59 Total PF System Interlock 

Bit 58 Request Total PF System Interlock 

Bit 53-48 PF Activity Count 

Bit 47-18 Reserved 

Bit 17-12 Default Family Equipment Number 

Bit 11-6 Alternate Family Count 

Bit 5-1 Reserved 

Bit Word Interlock 

* 5 This is the first word of any Pool -PP- exchange package. 

A pool PP will read up this word at preset time during deadstart 
and store it into its own core for later u se during an exchange 
jump. 

* 6 Delay for ISP to call CMS . 

The PF activity portion of this word is updated by every copy of PFM and all PF utilities . 
In order to avoid conflict with this field, the word is interlocked via the SFBM monitor 
function, which sets bit 0. Each PP routine will clear this bit when it has incremented 
the PF activity count. 

* 7 See table 2-2 to call CMS. 

* 8 This word is used to designate specific devices for these types of files. If the device 

should fill up, then overflow to any TEMP device. If active, then bit 11 is set and 
bits 0-5 contains est ord, bits 6-10 are zero. 



Figure 2-2. Pointers, Constants, and Control Words ( Continued) 
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TABLE 2-7. CMR 
This description corresponds to Figure 23-2 p. 23-18 



Address 



Byte 



Description 



0000 
0001 



0002 



0003 



0, 1 

2 
3 

4 
0, 1 

3 
4 




Always zero 
FWA RPL = 20547 
Number of PPU's ■■ 



24 



0014 = 0000 0000 001 100 

set. CMU and CEJ/MEJ present 

Memory size = 30000 = 98K system 

FWA PLD = 34131 

Number of CP's = 27 

FWA PPO OR = 6200 

Dayfile pointers FWA = 6400 



14 15 

bits 2 and 2 





1, 2 


FWA dayfile dump buffer = 15470 j 




4 


Number of excess dayfiles = 3 

SYSTEM, ACCOUNT, and ERROR | 


0004 





FNT FWA = 6700 ! 




1 


FNT LWA+1 = 7700 I 




3, 4 


JBC FWA = 11420 

FNT is 1000B words long or 400B files long 

i 


0005 





EST FWA = 6600 




1 


EST LWA+1 = 6700 




2 


EST RMS LWA+1 = 6602 

EST is 100 words long and at most there are 

2 RMS devices 


0006 


0, 1 


RCL FWA = 34130 


0007 


0, 1 


CLDFWA = 34313 


0010 


0, 1 


OLD for COS FWA = 35315 


0020 


4 


CMR size is 35400 


0032+35 




System date line 


0045 


3 


BATCHIO is at CP26 


0045 


4 


MAGNET is at CP25 

No other subsystems are active 


0057 





No CP is currently scheduled for a move 
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TABLE 2-7. CMR (Continued) 
This description corresponds to Figure 23-2 p. 23-18 



Address 



0060 

0061 
0062 
0063 
0064 and 0065 

0076 

0102 

0221 



Byte 



2 
3, 4 


4 
0, 1 

3 




Description 



CPU0 assigned to CP3 at CPA 600 

CPU0 EPA at 600 

CPU1 is not available 

PPl's EPA is at 20043 

PPR address in CPUMTR at 16736 

Auto load code for SFP, see Chapter 4 on 
PP Resident 

Channel 10 is assigned to PPl , i.e., DSD 
has the display channel. 

Channel 12 is assigned to PP6 

Note that CP1 is an available CP since 
the JNMW word is all zero. 



2-12.2 
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59 



47 



23 



017 
020 

021 



023 
024 
025 

026 

027 
030 

034 

035 

037 
040 

047 
050 

051 
052 
053 
054 



T 



Exchange' Package Area 



* 1 



No 
PPU 



Error 
Flags 



Pseudo 
Activity* 10 



REF Addr 
/100B 



Job 

Name 



Priority- 



Priority 



CM Resident 
Time Limit 



Seconds 



*3 



Job 
Oris 



*4 



Limit 



FL/100 B 



Operator Assig 
Equip *8 



CPU 
Allowable 



CPU Time Slice Limit 



Milliseconds 



PP Input Register 
PP Recall Register 



Bit 12 is PP Pause Flag 
Bits 6-11 are Sense Switches 



Keserved 



Message 1 Area 
1st Line B Display 



Message 2 Area 
2nd Line B Display 



Installation Area 



i ime * fa 

Limit 

Exceeded 



Start Time 
(CPU Seconds) 



CPU Time 
For Job 



CPU Time (MS) 
Milliseconds 



FL/100 * Time 



Number of Sectors 
Transferred 



Number of Physical 
Records Transferred 



CPU Time (MS) 
Milliseconds 



-I ! 



STSW 

JNMW 
OAEW 

JCIW 

TSCW 

CTLW CPU 
Time Limit 

RLPW 

SNSW 



MS1W 
MS2YT 

ACTvV 

jCPTW 
CMUW 

MSUW 
MTUW 



ACTWE, 
CPIW 



Descriptions follow: 



Figure 2-3. Control Point Area 
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* 1 W Bit 59 status Is waiting for CPU; if Bit 58 X status is set the control point 

Is in recall; if Bit 57 auto recall status is set CPU is in AUTO -recall. If 
Bit 56 is set, this control point has sub-control points active. Bit 53 is job 
advancement flag. 

* 2 Bits 33, 34, 35 are CPU status for rollout. This is a copy of 

W, X, R from word 20 (STSW) , so 1RI can set them properly on 
a subsequent rollin. 

* 3 If Bit 27 is set, rollout is in process. 
*4 If Bit 24 is set, rollout is requested. 

* 5 If Bit 35 is set, CPU time slice is active. If not set, time slice exceeded. 

* 6 2000B Is set. 

* 7 To convert from control point number to control point area address, left shift control 

point number by 7, as shown for CP3 and 2400B following: 

1st 2nd 

CP3 0110000000 „ J 
3rd 

6 OB 

Reverse 1st 

2400B 3rd 01010 0000000 B 

, „ __ 2nd 

1 2 CP 

4th 

* 8 OAEW is the EST number assigned by the operator. PP routines (LFM) retrieves this 

information from this byte and clears it. In addition, whenever TCS is called to process 
a new control card this byte is cleared. This implies that equipments cannot be 
preassigned by the operator. 

* 9 To make the message at MSIW on the B display flash, set the PP pause bit. 

* 10 For every request to CIO for tape activity/per tape, this counter is bumped by 1 . When 

1MT completes activity, it decrements the counter by 1. Maximum activity is maximum 
* number of drives (also see UADM) . This is a tape activity count, not a tape number 
count . 



Figure 2-3. Control Point Area *7 (Continued) 
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055 

057 
060 



061 
062 

063 

064 
065 



066 
067 

070 
071 

072 

073 

074 

075 
076 

077 
100 
101 

102 
103 

127 
130 

177 



59 








47 


35 




23 








11 


0^ 


11 f 1 
Reserved 


Job Card 

FL 


Last Card 

FL 


FL of 
Program 
CalUng 
DMP= 


Rollin 
FL 


Increase FL 
Req 




* 1 


Alternate Library File Name 


Map Cont. 


E~ui" 
Number 


Reserved 


Terminal Interrupt 
Address *10 


Output 
Pointer 


Auxiliary Pack Name (Default) 


EST ORD 
of Family 
Device 




*2 


User Number 


*8 


User Index 


400B 
=NO 
Exit 
Flag 


Error 
Flag 


Terminal Input 
Buffer 


Error Exit Return 
Addr 




Input Buffer 
Address 


Right Screen 

Buff Address 


Left Screen 
Display Address 


FST Addr 
of Input 


*4 


Control State- 
ment Count 


Next Sta- 
tement 
Index 


Limit 
Index 


*5 


Equip 
Numb. 


Firsi 
Track 


Current 
Track 


Current 
Sector 


Sector * 9 
Flag 


Job Sequence 
Number 




Demand File 
Random Index 


Project Number 0- 10 Characters With 
Zero Fill (Left Justified) 


Max Mag 
Tapes 


Max Disk 
Packs 


Max MS 
Tracks 


Max Work 
Files 


Max Jobs ; 
(Batch) ] 


Open Reserved [ Max CPU 

Priority 


Max Time 
Limit 


Max FL 

i 


Each Bit has Special Meaning 


Length of 
BUF 


Address 
of BUF 


Length of 
BUF 1 


Address of 
BUFF 1 




Event 
Descriptor 


Rollout 
Time Period 


*6 


Reserved 


DMP = Para 
meter 


SSJ = 
Parameter 


CP Prog 
Entry pt 
Name 






Status 
Return 


Parameter 
Block Addr 


EF 


R3 


R2 | Rl | 


Reserved 


Control Statement Buffer 



FLCW 



LDCW 

TIOW 
flAW' . 

■J SSG. 

for 
PFCW TELEX 

uidw ° f g 

„„,-. Jobs 
EECW, 

TTNW 

*3 



DBAW, K 
Display Control 

CSPW 



RFCW 
APJW 
APUW 

ACUW 

AACW 

ICAW Inter-Con- 
trol Point Comm 
Area . 

UPCW user I 

profile I 

SEPW 

SPCW Bit 47 is 
special processor 
request active 

JCRW * 7 



CSBW - 1/2PRU 
(40B CM words) ' 
of Control State- 
ment file. 



Descriptions follow: 

Figure 2-3. Control Point Area (Continued) 
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* 1 If set. Bit 56 is no field length reduction flag. 

* 2 The next three values indicate an index into a Table of Limits defined in 

COMSPFM. 

Bits 6-8 Indirect access file size 

Bits 3-5 Number of Permanent files 

Bits 0-2 Max cumulative size of indirect files 

* 3 Bit 47, set if error flag instead of error option. 

Bit 18, field 0-17 is reprieve error return address. 

* 4 If set, Bit 47 is EOR on control statement file . 

* 5 If set. Bit 59 is information is for input file. 

If set, Bit 58 is skip to exit flag. 

Bit 59 indicates that CC's are being accessed either from file INPUT or some other 
file . For example , with procedure files , CONTROL will have created a new CC file , 
set this word to point to its current track/sector, and eliminate the FNT/FST for the 
new CC file. However, the tracks are left reserved so that this job can keep this 
new CC file but FNT space is cleared. 

* 6 Special Entry Point Word 

Bit 59, indicate presence of entry points 

Bits 58-54, reserved 

Bit 53 ARG = entry point present 

Bit 52 DMP = entry point present 

Bit 51 SDM = entry point present 

Bit 50 SSJ = entry point present 

Bit 49 VAL = entry point present 

* 7 KRONOS CONTROL LANGUAGE registers and error flag (EF) . 

* 8 VAL= flag. = 1 VAL= SEP must be present in next program loaded via CC. 

VAL= SEP not needed. 

* 9 lst/2nd sector flag indicates to 1AJ which half of the sector of CC's is in the CSBW 

buffer . 



* 10 See TSEM request VSDT and VCDT figure 13-12, 



Figure 2-3. Control Point Area (Continued) 
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TABLE 2-8. EXAMPLE OF CPA AND PA + THROUGH RA + 100 



Foil No. 


Address 


Description 


1 


A 


Dayfile of Job. Job ran at GP3 which is 
GPA=600B. The dump is taken at the CC.4, 
ABSDMP (600B.. 1000B). Note that the job 
has requested and received one nine track tape 




B 


Job limits for CPA comparison 


2 


600 and 617 


Exchange package 




600 


P = 1732 




601 


RA = 30700 




602 


FL = 60000 




603 


EM= 0007 all errors 




606 


MA= 600 




620 


Status field 




Byte 


status = R, PPU No. = 1 




Byte 3 


RA = 307 * 100 


! 


4 


FL = 600 * 100 




621 


Name = MORRABWA 
Q Priority = 4010 



623 


CM Time limit = 3222 

GPU Time slice limit = 40000 


624 


Time limit = 1 sec 


630 and 637 


Message 1 and 2 area = 4, ABSDMP (600B, 
1000B) which is image of CC. 


650 and 654 


Accounting information 


650 


CPU time = 63 


651 


Start time = 61, FL/100* time = 2 


652 


Number of sectors transferred = 23 


653 and 654 


Job is not active so these fields = 


660 


Job card FL = 60000. Last card FL was job 
card = 60000. FL for DMP=call = 10000 from 
RESEX for REQUEST card. DMP= EQU 10000B, 
rollin FL = job has not been rolled in, FL 
FL increase request = 0. 


661 


from LIBRARY card = MORRIE 
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TABLE 2- 


3. EXAMPLE OF CPA AND PA + THROUGH RA + 100 (Continued) 


Foil No. 


Address 


Description 




663 


1PF cumulative size = 7 FC, PF limit = 5 = CS. 
IPF single size = 7 = FS. From old lev C of 
Install Handbook: 7 = unlimited, 5 = 50000B 
= 204800D compare to limits on foil 1 




664 


UN = MLO, UI = 1 




667 and 670 


INPUT file CC control 




667 


FST address = 3313, CC Count = 12 

Next statement index = 157, limit index = 170 




670 


Bit 59 set = information is INPUT file, eq no = 0, 
1st track = cur track = 4302. 


2 




Note: Sector no. = 1, flag = 1 indicates 1st 
half of sector, eor flag in word 667 is not set 
since CC's continue in the 2nd half of the 
sector. 




671 


lob seq No. = AABW 

Demand file rand index = 1 for assigned tape 




673 and 675 


Validation info from VALIDEX MT = 4, RP = 4, 
MS = 1750B = 1000D. Loc files = 628 = 50D, 
DB = 12B = 10D. PR = 77, TL = 7777, FL = 1071, 
AW = 7 7. compare to limits in foil 1 




702 


R2 = 1 from CC SET R2 = 1 




730 


One half pru of CC 




600 + 157 + 757 


Next statement index — "DMP (0, 1000) 




Note 754 


is last statement = current statement 




600 + 170 = 770 


Limit of CC or LWA + 1 of CC 


3 


1 


END, job is done 




2 


1st arg 600B 




3 


2nd arg 1 000B 




4 


Zero word to indicate end of arguments 




64 


CC which called this routine = ABSDMP with 
2 args 




65 


CMU present next word for load 1761 note that 
P = 1732 from CPA so SYS= "XJ" must be at 1731. 


3 


66 


CEJ/MEJ present job origin = 01 = BATCH. 1st 
word of object program is at 1 00 . 



2-16.2 
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TABLE 2- 


•8. EXAMPLE OF CPA AND PA + THROUGH RA + 100 (Continued) 


Foil No. 


Address 


Description 




70 and 77 


CC image ABSDMP (600B, 1000B) 




100 


Entry point address of this overlay = 1567 and 
LWA + 1 of last and largest overlay, in this 
case this is the only (0, 0) overlay, = 1761. 
Note word 65, next word avial for load is 
also 1761. 
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2 . 1 EXCHANGE JUMP 



An Exchange Jump instruction (XJ) starts or interrupts the central processor and provides 
central memory with the first address of a 16-word package in central memory. The 
Exchange Jump package (Figure 2-4) provides the following information on a program to 
be executed: 

1. Program address (P) 

2. Reference Address for Central Memory (RA„ M > 

3. Field length of program for Central Memory (FLp,J 

4. Reference Address for Extended Core Storage (RA Erc ,) 

5. Field length of program for Extended Core Storage (FLj^^o) 

6. Program exit mode (EM) 

7. Initial contents of the eight A registers 

8. Initial contents of the eight X registers 

9. Initial contents of B registers Bl - B7 (BO is fixed at 0) 
10. Monitor Address (MA) 

Central Memory Resident 

Peripheral and 
Control Processor 



A Register 



Central Memory 
Loc n 
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Descriptions follow: 
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Figure 2-4. Exchange Jump Package 



2-1' 



MA = Monitor Address 

P = Program Address A = Address Registers 

RA = Reference Address B = Increment Registers 

FL = Field Length X = Operand Registers 

EM = Exit Mode = 000000 Disable Exit Mode 

n n 010000 Address Out of Range 

uctal 020000 Operand Out of Range 

~°. Jr%o 030000 Address or Operand Out of Range 

Hits db-sd, 040000 Indefinite Operand 

Location n +d 50000 Indefinite Operand or Address Out of Range 

060000 Indefinite Operand or Operand Out of Range 

070000 Indefinite Operand or Address Out of Range 
or Operand Out of Range 

Figure 2-4. Exchange Jump Package (Continued) 

The central processor enters the information about a new program into the appropriate 
registers and stores the corresponding and current information from the interrupted 
program at the same 16 locations in central memory. Hence, the controlling information 
for two programs is exchanged. A later Exchange Jump may return an interrupted program 
to the central processor for completion. The normal operation of the A and X registers 
is not active during the Exchange Jump so that the new entries in A are not reflected changes 
inX. 

When an Exchange Jump interrupts the central processor, several steps occur to ensure 
leaving the interrupted program in a usable state for re-entry: 

1 . Instruction retrieval stops after all instructions from the current 
instruction word have been read. 

2. The Program Address register, P. is set to the address of the next 
instruction word. 

3. The instructions are performed. 

4 . The parameters for the two programs are exchanged . 

A subsequent Exchange Jump can then re-enter the interrupted program at the point at 
which it was interrupted, with no loss of program continuity. 

When CPU is in monitor mode: 

XJ K + Bj Bj+K points to Exchange package area 

When CPU is not in monitor mode: 

XJ Then (MA) points to Exchange package area 

Any B. -designation is ignored. 
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1 Byte Per Channel 

4 1 










PP Assigned 



^Channel Requested Set by CCHM check 

channel monitor request. 

Figure 2-5. Channel Status Table (CST) 



If channel 
not phys- 
Channel Not Available ically there, 
i.e. on a 
10 pp system, 
the upper 
channels are 
not avail- 
able. 
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Figure 2-6. Dayfile Buffer Pointers 
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Control Point Assignment 
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Various Uses 



Parameters 



Parameters 



Figure 2-7. PP Communication Area 



Mass Storage Devices: 
111111 6 6 
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TYPE 



Address/10 
of MST 



Primary CH 
'"Alternate CH 
■-Reserved 
■Device unavailable for access DSD UNLOAD request. 

- Checkpoint request pending * 1 

- Removable device 

■ Permanent files on device 
System on device 

■ Mass storage device indicator 



I Access not allowed for new files, but 
"-existing files can be accessed 
-First physical unit for device 
-Device selection for connect mode 
• Number of physical units for device 
■ Physical unit number 



Non-Mass Storage Devices: 
(3000 Type Equipments) 
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11 
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6 






CH 


CH 
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CH 
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U 
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C 




TYPE 


Q 

u 
I 
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N 
I 
T 



On/Off 
'Control Point Assignment *3 

Figure 2-8. Equipment Status Table 



\ 



Tape Options 
for 
MMTC 



2-20 



97404700C 



* 1 The .checkpoint requested fait in the EST is .set by: 

The CPR (checkpoint requested bit) set by any PP directly, i.e. , no monitor request, 
whenever it decides that the TRT should be saved on the device. There are two ways to 
set the bit. Either a PP uses the common deck COMPCKP or does it itself. The PP 
routines which use the preferred method COMPCKP are: 

PFM. Any change in the TRT, write, modify, append, extend, purge, etc. 

CIO, Only when a DA (direct access) PF has changed and forced a change in the TRT. 
Note: local files are not checkpointed specifically, only when some other action 
forces a checkpoint. 

IMS. When initializing MS or EDIT DA files . Note: EDIT DA function 2 will purge any 
DAs whose UI is specified in a MASK. (No users currently) . 

The PP's who set the bit themselves are: (This may not be a complete list). 

ORP. Whenever it releases a PF from a CP which has just written on it or it is purged 
and this is the last user of the file. 

PFU. When requested (function 14) by PFLOAD in routine EOL at end of load if any files 
were copied onto the device. 

*2 5 bits described in COMSMTX HP option under UDT description. See chapter 9. 

* 3 Set to 37B if job using this eq is rolled out. 



Figure 2-8. Equipment Status Table (Continued) 



97404700C 2-20.1 



An example of an EST is shown below. 



•BSOLUTE DUMP FROM 004200 



TO 



003200 7000000200010*11000 

003203 00000000U0Q000O00000 

003206 OOOOOOOOOOOOOOOOOOOO 

003211 000000121)0000322*000 

00321* oooooooooooooooooooo 

003217 oooooooooooooooooooo 

003222 oooooooooooooooooooo 

003225 oooooooooooooooooooo 

003230 000000030000632*ro00 

003233 OOOOOOOOOOOOOOOOOOOO 

003236 OOOOOOOOOOOOOOOOOOOO 

0032*1 2000011100*06*2*0000 

0032** OOOOOOOOOOOOOOOOOOOO 

8032*7 OOOOOOOOOOOOOOOOOOOO 

003252 000000130000552*6000 

0032S5 OOOOOOOOOOOOOOOOOOOO 

003260 000000130000162*5000 

003263 OOOOOOOOOOOOOOOOOOOO 

003266 OOOOOOOOOOOOOOOOOOOO 

003271 00000606000623037002 

00327* OOOOOOOOOOOOOOOOOOOO 



NT/ 



FF FSC*B 



P»Gt 1 
•50000020000**110515 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 

oooooooooooooooooooo 
oooooooooooooooooooo 

0000001200001*205000 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 

OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 

oooooooooooooooooooo 

000000 13000 01 52*6000 
000000130000552*6001 

oooooooooooooooooooo 

000000130000162*5001 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 



€-sr 

• B »IE« 



J LP/ 



MT= 
T=* 



K NT/* 



oooooooooooooooooooo 
oooooooooooooooooooo 

0000001000000*237000 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 

2000000300206*2*7000 

oooooooooooooooooooo 
oooooooooooooooooooo 

000000 130000152**001 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 

oooooooooooooooooooo 

00000606000623037001 

oooooooooooooooooooo 

0000000000002*050000 



FF FSC»* 



This is the CMR DECK which created the above EST . 



rMRnrrx 

W»MF = MflODTFS PtPSONOL KRONnS ?.l. 
tOCipT-l .ONtl.l ??. 
PF , S0,D J 377.MORR:,4n. 

ftTK = J.ri n7,Tia,!>nn. 

"TKaO.Cl '>7.TI2,S01 . 
•TK = o.'"4'?<,,T13tS?l . 
"TK=o.rt37.T13.S?l. 
: TK = 6 ,r44?.T13tb?1 . 
F<51«QT-1 .OPF«0.0f?. 
RFMOvF.l . 

eo ) o »os • "n • 7 • o • i 1 • 



EOll -CB.fm.tiOi 1?. 

EQ20*l o '°N. 1 ii0l 1?. 

t f )Si,-5T.orr.7,« J. 
E04niTT.nrF.7,, i, ,?o. 
f 0*1 -TT.nFfinit ) 1 ,1 .40. 

fOS'i^T-P.OFFtftjn.ll. 

fO6liNT-?.QNt5.0,13. 
fo 7 o-sr.npj, 7. ].»»*,.#». 
E<37 l*sr,riH.7,3 1 6. *,,#>. 



Figure 2-8. Equipment Status Table (Continued) 
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Figure 2-10. Input Queue Files 
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Can be changed by SETID card, 
(e.g. if a user wishes to route 
his output to a particular printer) 



The DSD command is: 
LPXX, YY 
Where XX = EST and 

.YY = id # 



Figure 2-11, Print Queue Files 
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Figure 2-12. Files in Punch Queue 
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Figure 2-13. Files In Rollout Queue 
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Figure 2-14. Files in Timed/Event Rollout Queue 
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If last operation was write or position, bit 2 
operation complete = IN = OUT = FIRST 



Figure 2-15. Mass Storage Files - Assigned to a Job or Common 
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In order to get multi-user read on locked COMMON files, every user who requests this file 
gets a separate FNT/FST pointing to the file and its type is set to LIBRARY. 

Multiple fast attach files (FA) are handled by PFM or any PP, if more than one family is on the 
system, in the following manner: 

FA files are accessed by PFM for CP routines and PFM will generate a local FNT/FST copy for 
the user. It is faster, since PFM always checks for FA status . PP routines can check the eq 
number of the file in the FNT/FST and determine if this device resides in the family which it 
is accessing. 
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Figure 2-16. Magnetic Tape Files 
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Figure 2-17. Fast Attach Permanent Files 
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Fast attach files are permanent files that have been given FA status by the ISF Initialize 
System Files. ISF generates FA status for RESEXDF, RESEXVF, and VALIDUX, PROFILO for each 
family on the system. The FA technique is designed to achieve fast access to certain PFS, 
since PFM checks for FA status on a PF first. 

Figure 2-17, Fast Attach Permanent Files (Continued) 



The following is an example of an FNT . 



ABSOLUTE DUMP r«0« 00331)0 TO 0013*0 

003300 ii3 U3i«o «isoaaiE5po system as 

0033*3 OOOliQSSooOOOOOOOOOS 7a E 

00330k 220«.Jjai300»n6001300 OESEXOr K 

003311 oooa Baj oooooooooooS 7« E 

• ooJ3i» o»asi'52ooios?3oooao3 au»aiES » 

003317 ooooooooooaooooooool * 

003372 OOOOOOOOUOOOOOOOOOOO 



FNT/FST 



ptat 



1 



O0OO «>O0jf »OOl 00010005 

23Oll±£ftO1220SO00 70l 

oooa »;tg ooooocoooooi> 
ui«> ea;9 2»»7oaoiooii 
oooofeeajttj 10021 o»io 

1725J»d(12S2»00000211 
OOOOOOOQOOOOOOOOOOOO 

"ACTIVE FILES 



5ASA A E 
SAL VASE 01 

7v c 

INPUT* A I 

-*-0 Qnn 
OUTPUT A. 



26llll*J^0*2SJO001 300 

000O»iI3»a7!,000?<m* 
22OS23O530?'>0iO01 300 
0000*01 2*»1 200020005 
3*152>J_5ol0«200on»10 
QO0a *622| K>22000Jn70 7 

aooooooooooooooooooo 



VALIOUI ■ 

OESFIVF « 

-J-J a E 
1MTHA0P FM 



Job Name 
None 



FNT Number 



None 

TELEX 



None 


3 


None 


4 


DIS 


5 


Output 
Queue 


6 


MAGNET 


7 


DIS 


10 



TYPE 
CMFT = 7 



FILE Name 
SYSTEM 



1st Track 



C.P. 



1 FAFT = 13 VALIDUX 

2 CMFT = 7 SALVARE 



FAFT =13 RESEXDF 

FAFT = 13 RESEXVF 

INFT = INPUT* 

PRFT = 2 DUMPAES 

LOFT = 6 IMTHADP 

PRFT = 2 OUTPUT 



Note that the 
write lockout bit 
is set. Hence, 
this is a locked 
common file . 



264 







576 


1 


Note that the write 
lockout bit is not 
set. Hence, this 
is an unlocked 
common file. 


266 







267 







612 


11 




615 







None 


10 




622 


11 





CMFT - common 
FAFT = fast attach 
PRFT = print 
LOFT = local 
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MST + 



24 



TRTL TRT Definition 
12 



12 



12 



Number of Available 
PRU's (Minimum) 

*1 


See Table 7-1 
Length of 
TRT in CM 
Words 


Reserved 


Number of 
Available 
Tracks left 
to assign 



MST+ 1 



12 



MSDL Mass Storage Driver Words 
111 9 18 



Current Posi- 
tion of device 
(808, 6603 
only) 



Single Unit 

Sector 

Limit 



Maximum 
Sector 
Limit/ Trk 



18 



Minimum 

Sector 

Limit/ Per Trk 



-Reserved 

-Release Reservation When Channel Released 

-Format Pack Request Pending (844 Only) 



MST + 2 
MST + 3 



Reserved For Mass Storage Drivers 



Reserved For Mass Storage Drivers 



*2 



DEVL Device Allocation Information 



MST + 4 



12 


12 


12 


12 


12 


First Track of 


Label Track 


1st Track 


Actual Num- 


System 


Indirect Access 


(Linked to * 3 


of Permis- 


ber of 


Table 


Files 


Catalog 


sion 


Catalog 


Track 




Tracks for 


Informa- 


Tracks 


* A 




P.F. Master 


tion 








Device) 









Figure 2-18. (MST) Mass Storage Table 
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* 1 Minimum PRUs available is No of tracks avail * min sector limit. This value is computed 

by CPUMTR so that PP's don't have to perform the calculation. It is used when deciding 
if a particular file will exceed the device size . 

* 2 Used for dumping messages for error recovery. 

* 3 See PFDL MST + 6 word. 

* 4 A copy of CMR is written on this track when CHECKPOINT SYSTEM is requested. It is used 

for Level 1 and 2 recovery. 



Figure 2-18. (MST) Mass Storage Table (Continued) 
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PFIL Permanent File Interlock Word 



MST + 5 



-Mass Storage Device 

-System on Device 

•F.F, on Device 

-Removable Device 

-Reserved 

-Direct Access Files may Reside on This Device 

-initialized Request Pending 



18 



12 



Re- 
served 



c 



Reserved 



Current User 
Count of 
Direct Access 

Files 



Alternate System Device 
Available For System Allocation 
Auxiliary P . F . Device 
■Not Available for Access 
(unload Status) 



^ 



T 



Device Interlock bit 0— ' 
(Clear means device busy) 

Device Interlock bit 1 

(Set means utility active) 

Device in Use, bit 2 

(Set means multiple eq chain) 



Next Equipment in Multiple Equipment Chain 
Original Number of Units for Equipment 



MST + 6 



PFDL Permanent File Description 
42 6 



1 1 2 



Family or Pack Name 



Device Device 

Number | Mask 

\^Reserved * l | 

Catalog Tracks 
Have Overflowed 
Catalog Tracks Con- 
tinuous with Label Track 



MST 



PFUL Permanent File User Description 



42 



User Number for Private Pack 



3 3 




-Number of Unit in Multi- 
Unit Device 

■•Relative Unit In Multi- 
Unit Device 



Figure 2-18. (MST) Mass Storage Table (Continued) 
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* 1 PFDL in MST 

a, bit 11. Catalog track continuous with label. 

b. bit 10. Catalog tracks have overflowed. 

- «T« -.11.. *U A TSQPT +««1. 4 e. t. a /.V ft 3.«/4 rtTi DV ^cwH«ae tKo ^a+al^rr «-i-a^V<; uH 11 hS 1 "^ " 

with track 1 and make a contiguous chain. In fact, the LABEL track is considered the 
first logical track in the label track chain and contains the system sector. It is 
possible due to flaws that track is unavailable , In which case the label track will be 
the 1st available track in the catalog track chain. 

If the tracks following the LABEL track are available, then they will be linked. The 
catalog tracks must be contiguous, however, they need not be contiguous to the last 
label track. 

Commonly on a PF device that contains the SYSTEM , track is the LABEL track and 
track 1 starts the file SYSTEM . The catalog tracks start after the system file . In 
this case, this bit is set on. 

Note: LABEL track plus catalog tracks are considered one track chain, so the TRT 

will link these tracks together. This bit tells PFM where to look for the catalog tracks. 

b. PFM computes the catalog track for a UI (see Install Handbook pp. IV-2-3 thru IV-2-8). 
If this track is full PFM overflows to other tracks (not any of the original catalog 
tracks) . This bit Just indicates to PFM that overflow may occur when searching for a 
hole for this operation. Also the symbol is displayed on the EM display for the 
operator's edification. 



Figure 2-18. (MST) Mass Storage Table (Continued) 
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Rest of MST (MSTL - 10) 



MST 



10 
11 
12 
13 
14 
15 
16 
17 



Reserved 



Reserved 



Reserved 



Reserved 
Reserved 



Installation Use 



Installation Use 



Installation Use 



not 

currently 

used 



Figure 2-18. (MST) Mass Storage Table (Continued) 



Entry = 1 Byte + 1 Bit for each track 
Track Link byte may take 1 of 2 forms 

1 11 



1 



Next Track 
In Track Chain 



11 



EOI Sector 
in File 



The next track is found from 
1 9 2 



1 


Word in TRT 


Byte 
in 
Word 



TRT Word 



12 




12 


12 


12 


4 




4 




4 




Track Link 


Track Link 


Track Link 


Track Link 












p 










Track interlock 
Track reservatit 












>n bits 











Figure 2-19. TRT Track Reservation Table 
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RCL - Resident CPU Library 



(Absolute programs only) 
41 



Jyp 6 „ lo 

"OVL" 



Program Name 



41 



Type 
"ABS" 



18 



I Length 



Links to next program 
18 



1 


Program Name 


Length 



^Links to next program 



RPL - Resident PPU Library 



18 


6 


12 


12 


12 


Program Name 





Load Address 





| Length 













Links to next program 



PLD - PPU Library Directory 
18 



12 



12 12 



Program Name 




Load 

Address 


Track 


Sector 



T 



Alternate System Device 
EST ordinal if it exists 



Figure 2-20. KRONOS Library Formats 
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Type "OVL" 







5 


1 


6 


6 


Program Name 


' 


Scope 

Rec 

Flag* 


Alt 
Dev 
Eq No 





12 'Bits 



*1 24 Bits 


Track 12 Bits * 2 


12 Bits 
Sector* 2 



Type "ABS" 

Set bySYSEDIT 
because RFL= 
SEP was pre- 
sent. 



* 3 





42 




5 


1 


6 


6 


1st Entry Point Name 


• 


Scope 
Rec 

Flag 


Alt 
Dev 
Eq No 


No. 

Entry 

Pts. 


12 Bits 
FL 
Required 


24 Bits 
*1 


12 Bits 
Track *2 


12 Bits 
Sector *2 


2nd Entry Point Name 


wwmm, 



Type 

"ULIB" 



NTH Entry Point Name 



36 



42 


6 


12 


Library Name 


1 




Random Address BIAS 



24 



42 




6 


12 


Procedure Name 











Random Address BIAS 



36 



24 



The user library definition entry for a given compiler will exist after the 
(0, 0) overlay entry for the compiler . 



Type "ULD" 



Type "COS" 









ULD User Library Definition 







Library Name 





1 41 


18 


T 


Program Name 








Track 


Sector 



T=0— PMode *If set, specifies that card cracking from TCS is done in SCOPE for- 
mat. If not set, then TCS card cracking is in KRONOS format. 

*1 Used to specify ALT system TRK and sector if specified. 

T=l— I Mode *2 Used to specify system TRK and sector. 



Figure 2-21. CLD - CPU Library Directory 
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* 3 If alt dev eq no = and * 1 / 0, then CM resident routine and * 1 is address of routine 
relative to FWA of RCL. In fact, there is a CLD entry for every CP routine on the 
system, and 1AJ never needs to search the RCL explicitly. 

Figure 2-21. CLD - CPU Library Directory (Continued) 



The following is a copy of a dump of part of the CLD and a CATALOG of this section. 
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tf 
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027 
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027 
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027 
027 
027 
027 
027 
027 
027 
027 
027 
027 
027 
027 
027 
027 
.027 
027 
027 
til 
027 
027 
027 
C27 
027 
027 
027 
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027 
027 
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030677 


BCS 


CI »C 1 


«*• 


bd kr 


CHESS 


J sj t 


ceriht 


PERMIT 


SAVE 


5J • 


pfcqpyi 


SK 


pfs r 


• pfdump 


pfcopy 


N 9L N 


FL*» 


SH ♦ 


CHAR0E A 


I5P * 


HOOVAL C 


PASSMCH 


AH 5N * 


9NAI 


■ OATAUEF > 


SPAR 


KTSOKP 


Ad SRA* 


THANE X 


SU 


TRANS1H A 


aOHLIH * 


.•• 


TE.rj 


sv s 


BLANK A 


magnet 


9XA# 


L'BEL 


VSN 


REO 


52 II 


. CATL1ST 


A SZAP 


COMMENT L 


NOtXlT 


OFFSV 


SETPR 


SWITCH 


V 9XA« 


DISPLAY C 


SET 


AS SO J 


COPYEI 


i BO u 


COPY*.? 


• B8 » 


DMP 
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sc • 

BD «• 

OCHPTK A 
AOSOHp 

B«A» 
ATTACH 
BET 
PURSE 
6K 
PPCAM 

BJAX 
PFLOApJ 

U BKA* 
PPCAT 

BD E* 
NS1 " 
5D 2< 
FAMILY 



J 
2 

*1 

BL 
59 



BH | 

BHAH 

BHAO 

«■! 

ss 



E200CP 

BOaZ 

OSFORH 

♦ • SB t 
PflCSIH 

9T > 

TBAHEXJ • 

B BUA6 

SK 

BTIHULA 

sa ». 

TELCX2 

N BXAt 
SXAV 

ASS10N H 

NEWEST 

IFM 

U H B< 

CAT HOB 

2 51 | 
SFP 

D 92AJ 
OMEXIT 
PFL 
SETTL 
USECPU 
EXIT 

H SB A 

SS 

C0PY9C 
CC?YS 
COPYCf 

• •• 1 
DHO • 
ISC ' 
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JYSEOIT 
TSS70 
B SJ ^ 

9BAH 
APPEND 4 
CHAHfE 
p/CKNAH 
BEPLACE 
PFATCl 

9j • 

prouMPi 

SK I 

pruoAo 
prAie 

PUROALL 
• Sl I 

ACCOUNT S 
$*» . M 

B« P 
SO 8- 
LlHITS 
PROFILE A 
SfB 

so r 

OATAHAP 

sa i. 

LlBTASK 

SS * 

TRANEXI 

Sua i 
SD AZ 

TKANLIGA 

I 5K H 
TtLfXl 

sx e 

B» L# 

H*3NETI 
A SXA* 

RESOURC 

PFH 

FlRHttX 

n tz } 



CKP 

9T 

KOOE 

Ohsx 

ROLLOUT 

SU1 

CALL 

GOTO 

17 

COPY 

COPY8R 

C0PYS8P 

COPYCB 

COPYTB 

Si to 

toe 



B 
•I 



CATALOO Or SVSTEM 

name iype 



O 



■~1 

o 



l»3 

m 
>«» 

499 

zoo 

201 

lot 

203. 

204 

20S 

204 

2or 

IS* 



tot 

210 
211 
212 
211 

21* 
213 
2U 
IIT 

211 



21* 

224 
221 

^^^ 

22) 
224 



22S 



93A 
908 ■ 
90C * . 
900 

9CE 

9or 

900 

»oc 

H»T 

rse 
.dpm 

TSSTfl 

OUHfTN 
DUMPTK 
RFL» 
S5J« ' 

AttSDHP 

CHO 

chess 
. uoa 

9I» 

OSl 
0»R 
HUH 
1001 

MILES 

' apcenO 
ATTACH 
CHANSC 
OIFJ.nE 
OCT 
PACKMAN 

permit 

P.URGE 

HtMLACC 

SAVE 

RFL» 
SUM* 

PFATCI 

prcATi 

PFCOPY1 
PFUUMPl 
PFLOAUl 
PFS 

PFS 

PFLOAO 

pfouhp 

PFCAT 

PFATC 

pfcopy 

KFL* 

5SJ« 

POHOAUL, 

. PUROALL 



PP (623T» 

PP (62)71 

PP i«jr» 

PP (62)71 

PP (62)71 

PP (42371 

PP (62371 

PP moat 

PP (1I00» 

PP (11001 

PP (1 1001 

PP (11001 
OVL 00* 00 
ABS 



OVL 00,60 

pp niooi 

OVL 00.00 
PP (1100) 
PP 1)105) 

PP (tits) 

COS 

PP (1100) 
SUN • 



»»» 



OVL 01,00 
OVL 01,00 

ovu oi,»6 
ovl oitoe 

OVL 01«00 
ABS 



Al> 



FILE 
L1NUTH 

Tl 
66 
61 

50 

T6 

67 

99 
1137 
1(70 
1*6. 

71 

46 

*S«57 

llJl 



l«"ftl 
•7«7» 

' ?50 

634 

BIAS 

*63 

104707 

i»»t 



2>30 
3?»2 
EfOO 
6)06 
7«74 
1*51 



I 

CKSUH 

2360 
J74l 
0315 
1306 
4244 
6301 
3507 
0S13 
40T6 
1527 
1441 
SS57 
3131 
6702 



0564 
1753 
2520 
JT60 
4017 
7)70 
1712 



DATE 

74/04/26. 
74/04/26. 
74/04/26, 
74/04/46. 
74/04/26. 
74/04/26. 
74/04/26. 
74/04/26. 
74/04/26. 
73/06/19. 
73/06/19. 
73/06/19. 
73/06/19. 
73/06/19. 



COMMENTS 

73/05/24, 
73/05/24. 
73/05/24, 
73/05/24. 
73/05/24, 
73/05/24, 
73/05/24. 
71/01/09. 
71/03/02. 



TSS70 



T*/0»/2l. 20. IT. 5*. 



PAOE 



II 



74/04/26. 026 - FILE COMMANDS. 

74/04/26. 026 - LINE ENTRY AND DAT* MOVE* 

74/04/26. 026 • 0I5PLAY, TAD, OOP AMD SCAN CONTROL. 

74/04/26. 026 - LINE SEARCH COMMANDS. 

74/04/26, 02o - B,-C0i:0 SEARCH COMMANDS* 

74/04/26. 026 - R£?LAC£ COMMANDS, 

74/04/26. 026 • MISC. COMMANDS* 

72/05/19, ANDY CAPP OISFlAY. 

73/03/00.' BASEBALL OAMt. 



73/06/21. ABSUHP 

74/04/46. .71/1)1/09, T3/12/17, CHESS DISPLAY DRIVER, 

02/10/70. 
74/04/26. 73/0S/0S. . SNOOPY W*l FLYINO ACE* ' 

74/04/46. 73/OS/OS, ACE - DISPLAY OAT*. 

74/04/26. 71/01/00.. 73/09/06, 6612/DD&0 U1SPLAV ALIONMCNT TEST. 



1473 74/04/26. 71/01/09. 72/09/1** MORHJS) DISPLAY. 

1074 74/04/26. 73/09/14* 74/03/11* PERMANENT FILE MANIPULATOR* 



'j» 



6636 74/04/26, 73/05/24. 73/08/19. PFATC1 • CATALOO PF ARCHIVE TAPE, 

66)4 74/04/26. 73/05/24, 74/04/26. PFCAT1 . CATALOO PERMANENT FIIE DEVICE. 

0205 74/04/26. 73/05/24. 74/04/26. PFCOPY1 - COPY ARCHIVE FILE UTILITY. 

741S 74/04/£6. 73/45/24. 74/04/26, PFDUHPI - PERMANENT FILE OUMP, 

6004 74/04/26. T3/U&/24. 74/04/26. PFL040J - PERMANENT FILE LOAD* 

0303 74/04/26. T3/U9/Z4* 74/04/26. PERMANENT FILE SUPERVISOR* 



$♦• 



7601 74/04/26. 73/0S/0S* 74/04/26. PURSE ALL PERMANENT PILES. 

CATALOG (SYSTEM) 



NOTE 

Order for JBC 

SYOT 
SCOT 

EIOT 

TXOT 

MTOT 

For Each Job Origin Type, There Exists A 10B Word Job Control Area 
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Figure 2-22. Job Control Area (JBC) 
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LOG 



DESCRIPTION 



NAMES 



DEFINITION 





59 


47 


35 


29 23 






1 


1 





RA 


1 III 


T 


P 


CO Ul 
■A CD 

5- B 
S" to 
g.» 

cd 

CO 


cow 

go 

to SJ 
ro 1-3 

I-.M 

CO 


RA+1 


Package Name 


*1 


Arguments 


2 




63 




64 


Name 


No. of 
Parameters 


65 


* 2 


Reserved 


Address of 
next word 
available 
for loading 


66 


*3 


Reserved 


Job 

Origin 

Type 


Res- 
erved 


First 
Word 
of ob- 
ject pro- 
gram 


67 


Reserved 


*4 


Reserved 


70 




77 




100 


*5 


Name of alternate user library 
(ULIB) *7 




101 





ARGR 



PGNR, 

ACTR 

LWPR 



T= Storage Move Flag 
P=Pause Flag, if set, 
program will halt until 
cleared by go from 
console . 



Used to communicate 
with CPUMTR. 



Parameters from the 
program call card. 



Name of program called 
by Control Card . 



XJPR, Job Status 
JOPR 



LDRR Loader Status 



CCDR Image of control card 

currently being executed. 



Actual first word of 
user program 



* 1 Bit 40 is auto recall bit. 

* 2 Bit 59 is set if Compare/Move Unit (CMD) is present. 

* 3 Bit 59 is set if CEJ/MEJ available. 
*4 Bit 29 is set if Load has completed, 

* 5 Bit 58 is set if program called from DIS. 

Bit 56 is set if no automatic field length reduction. 

* 6 Map flags for LINK: 

0001 Statistics and errors 0004 Entry points 

0002 Block assignments 0014 Cross-reference of entry points 

* 7 If an overlay is loaded, ULIB is overlayed in bits 35-18 with lwa+1 of last largest 

overlay, i.e., the origin of the CM area that may be used for dynamic storage 
allocation. 

Figure 2-23, Control Point RA Through RA + 100 
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The following abbreviations and definitions are used throughout this and succeeding sections. 



Abbreviation 




u 




MM 
PTX 
ATX 
CPU 



Definition 

CPU monitor 

PP monitor 

Exchange package 

Exchange package area 

Control point 

Sub control point 

Control point area 

Physical central processor and hardware assigned 
to CPUMTR or CPn 

Physical peripheral processor and hardware for PPn 

CP Executive 

Monitor flag 

Error flag 

Monitor address of EP 

Error modes 

A symbol enclosed in parentheses means: 
contents of 

Flowchart continuation symbol for off page 
reference 

Flowchart start or continuation symbol for on 
page reference 

Monitor mode i.e. , MF = 1 

Prior to exchange jump 

After exchange jump 

Central processor unit 
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Abbreviation Definition 



FWA First word address 

OR PP output register 

IR PP input register 

QP Queue priority (priority that governs which jobs in the 

rollout and input queue gain access to control points), 
also which output queue entries gain access to printers 

_ CPU priority (priority that governs which jobs at 

control points gain access to the CPU) 

— CPU Time Slice (the amount of time a job can use the- 

CPU before it becomes a likely candidate for rollout) 

_ CPU Time Slot (Job Switch Time) (the amount of 

time one control point can be active in the CPU prior 
to the CPU being given to another control point) 

- CM Time Slice (the amount of time a job can occupy 

central memory (control point) before it becomes a 
likely candidate for rollout) 



3. 1 CPU AND PP MONITORS 

In KRONOS 2. 1 there are two separate monitors: CPUMTR (central memory monitor) which 
controls CPU monitor mode execution and CPU scheduling, and MTR (peripheral processor 
monitor) which is in general control of the system and operates in PPO. 

These two monitors work together, yet independently to allow the system to run smoothly 

and effectively. 

Figure 3-1 is an overview of system interaction showing both monitors as a controlling 
entity. PPs communicate to CPU and vice versa through monitor by means of IR, OR, and 
RA+1 calls. 

Figure 3-2 shows the interaction between this monitor concept and PP resident using the PP 
IR and OR. 

Figure 3-3 shows the monitor interaction between CPU, PPU, and each monitor using the 
exchange jump feature. With the CEJ/MEJ option, the CPU program can either wait for 
PPMTR to call CPUMTR by finding (RA+1) t 0, or the CPU program can directly call 
CPUMTR. PP routines may either wait for PPMTR to call CPUMTR by finding the (OR) t 0, 
or call CPUMTR directly. Without the CEJ/MEJ option, CPU routines and PPU routines 
must wait for PPMTR to call CPUMTR for them. 

Figure 3-4 shows the entry points for CPUMTR, while Tables 3-1, 3-2, and 3-3 show the 
monitor functions processed by CPUMTR. 
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Figure 3-1. System Interaction 
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Figure 3-2. System Interaction 
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Figure 3-3. Monitors Interaction 
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Address in CPUMTR 
as of 8/1/73 


Name 


20 


MTR 


717 


PMN 


1007 


PPR 


1357 


PRG 



1632 
1635 



IDL 
IDL1 



Description 

From CPU program 

From PPU monitor 

From pool PPU program 

Address where system CP begins 
execution in program mode. When 
system CP exchanges to the 
CPUMTR, CPUMTR will begin 
execution at MTR 

From CPUMTR. These are idle 
loops for*CP0 and CP1 
respectively 



Figure 3-4. CPUMTR Entry Points from Exchange Packages 

All system interaction is affected using the exchange jump instructions. 

The executable code of CPUMTR begins at location dayfile buffer + dayfile buffer length. 
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Functions processed by MTR for Pool PPs enter CPUMTR at PPR? 

TABLE 3-1. VALUES OF PP MONITOR FUNCTIONS (as of August 1973) 



Name 


Value 


Description 




1 


Assign equipment 


AMSM 


2 


Assign mass storage space 


CCHM 


3 


Check channel 


DCHM 


4 


Drop channel 


DEQM 


5 


Drop equipment 


DFMM 


6 


Issue dayfile message 


OFEM 


7 


Off equipment 


1 ONEM 


1 n 


On equipment 


! PRLM 


11 


Pause for storage relocation 


j RCHM 


12 


* Reserve channel 


REMM. 


13 


Request exit mode 


REQM 


14 


Request equipment 


ROCM 


15 


Rollout control point j 


RPRM 


16 


Request priority i 


RJSM 


17 


Request job sequence number 


SCHM 


20 


Select mass storage channel 


RSTM 


21 


Request storage 


RSYM 


22 


Request system 


SMSM 


23 


Set monitor step 


STPM 


24 


Step monitor 


TGPM 


25 


TELEX get pot 


TSEM 


26 


TELEX request 


DEPM 


27 


Disk error processor 


DRCM 


30 


Driver recall CPU 


SCPM 


31 


Select CPU(s) allowable for job execution 


EATM 


32 


Enter Access system event table 




33-35 


(Spares) unassigned 



-The value determines that the function is intended for MTR. 
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I Functions processed by CPUMTR, enter CPUMTR at PPR. 

TABLE 3-2. VALUES OF CPUMTR FUNCTIONS (as of August 1973) 



Name 


Value 


Description 


ABTM 


36 


Abort control point 


CCAM 


37 


Change CP assignment 


CEFM 


40 


Change error flag 


DCPM 


41 


Drop CPU 


DJSM 


42 


Disable job scheduler 


DTKM 


43 


Drop tracks 


DPPM 


44 


Drop PP 


ECSM 


45 


ECS transfer 


RCLM 


46 


Recall CPU 


RCPM 


47 


Request CPU 


RDCM 


50 


Request data conversion 


REWM 


51 


Read ECS word 


RJAM 


52 


Request job accounting 


RPPM 


53 


Request PP 


RSJM 


54 


Request job scheduler 


RTCM 


55 


Reserve track chain 


SFBM 


56 


Set file busy 


STBM 


57 


Set track bit 


UADM 


60 


Update accounting and drop 


WEWM 


61 


Write ECS word 


JACM 


62 


Job advancement control 


DLKM 


63 


Delink track chain 


TDAM 


64 


Transfer data 


TIOM 


65 


Tape I/O processor 


RTLM 


66 


Request time limit 


LCEM 


67 


Load central program from 
ECS 


CSTM 


70 


Clear storage 


CKSM 


71 


Checksum for reprieve 




72-75 


(Spares) unassigned 


MXFM 


76 


Maximum number of functions 
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Functions issued by MTR (only) and processed by CPUMTR enter CPUMTR at PMN. 



TABLE 3-3. MTR FUNCTIONS PROCESSED BY CPUMTR 



Name 


Value 


Description 


ARTF 


1 


Advance Running Time 


IARF 


2 


Initiate Auto Recall 


MSTF 


3 


Move Storage 


MRAF 


4 


Modify RA 


MFLF 


5 


Modify FL 


SCSF 


6 


Set CPU Status 


SMSF 


7 


Set Monitor Step 


CMSF 


10 


Clear Monitor Step 


CAEF 


11 


Check Arithmetic Error 


ACSF 


12 


Advance CPU Job Switch 


PCXF 


13 


Process CPU Exchange Request ] 



RA+1 REQUESTS PROCESSED BY CPUMTR 



MSG 

CIO-CLO 

ABT 

LDR 

CPM 



END 
RCL 

TIM 
*RSB 

RFL 

XJP 
**TLX 

XJR 
*SIC 



Send dayfile message 

CIO call 

Abort this CP 

Call absolute overlay LDR 

CP Functions 1) Force upper 

2) Set error exit 

3) Read exit mode 

4) Read Job Control word 

5) Set job control word 

6) Return user number 

7) Read FL control word 

End this CP normally 
Periodic or auto recall 
Request system time 
Read subsystem control block 
Request field length 
Initiate Sub Control Point 
Process special PPU request 
Process Exchange Jump request 
Send Inter-CP block to subsystem 



*This request is only honored for jobs with "SSJ=" or * *. 
: *This request is only honored for jobs whose queue priority is greater than MXPS. 



97404700A 



3-9 



NOTE: The format for the calls on these pages are contained 
in the Instant Manual and the EXT documentation of 
MTR and CPUMTR using the control card DOCMENT. 

3.1.1 Monitor Function Descriptions (See Instant Manual for parameters) 

3.1.1.0 MTR Functions 

Function Number 

1 AEOM - assign equipment 

It is used by DSD/IDS for n. ASSIGN command. The equipment is reserved in the EST if 
it's not MS. Bits 47-52 of the EST will get the CP number to indicate the reservation. 

2 AMSM - assign MS space 

This function allows a PP to request n sectors of MS space on any TEMP device. See 
paragraph 7.S p. 7-8 for further description. 

3 CCHM - check channel 

This function allows a PP to have a channel checked for availability. If the channel 
is free, it is assigned, if not free, the channel requested bit 11 in the CST is set. 
In any case control is returned to the PP immediately. Compare this with RCHM. 

4 DCHM - drop channel 

Simply sets assignment for this channel in the CST bits 7-10 to zero. It is used to 
release the channel reserved with RCHM or CCHM. This function is used by the PPR 
routine DCH , see chapter 4 . This also does a Release unit reserve function when the 
device is MS and the R option is set for a dual access controller. See the CMRDECK 
MS EST entry in the Install Handbook. 

5 DEQM - drop equipment 

This function releases the equipment by setting bits 47-52 of the EST entry to zero. 
It is used to release equipment reserved with the AEQM, or REQM, 

6 DFMM - process dayfile message 

This function allows a PP to send a dayfile message to any of the system or CP dayfiles. 
This is used by the PPR routine DFM, see chapter 4. 

7 OFEM - off equipment 

This function sets the OFF/ON bit 23 in the EST on. Note bit 23 = 

equipment ON 

1 equipment OFF 
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10 ONEM - on equipment 

This function sets the OFF/ON bit 23 in the EST OFF. 

11 PRLM - pause for storage relocation 

Any PP which determines that its CP has a storage move request pending (CMCL word 57 
byte 0} must issue this function. MxR will not move the CP until all P? activity for that 
CP has ceased which is either a DPPM, PRLM, or CCAM, etc. This function is used by 
the PPR routine PRL see chapter 4, 

12 RCHM - request channel 

This function sets the CST bits 7-10 to the CP number, thereby assigning the channel, 
for whichever of up to 4 channels is available. The RCHM will not return control to the 
PP until the channel can be reserved. Compare with the CCHM which returns control 
whether the channel can be assigned or not. 

13 REMM - request exit mode 

This function sets the EM in the EP to the specified 12 bits. The EM register is in 
EP+3. 



3 6 3_ 12 18 18 

EP+3 



EM V///A EM 



B3 



14 REQM - request equipment 
This function allows the PP to request an equipment. Control is returned whether the 
equipment is available or not. 

15 ROCM - rollout CP 

This function sets the rollout requested bit (bit 24 in word ICIW, 22 of the CPA) on. 
A PP routine cannot force a job to rollout immediately, it must request rollout action. 
MTR will determine when the job should be rolled out and MTR will issue the JACM 
request option 5 . See ]ACM. 

16 RPRM - request priority 

This function will set the CPU or queue priority in the CPA (word ICIW, 22). 

17 R]SM - request job sequence number 

This function returns the current job sequence number from JSNL word 22, and bumps it 
by one. 

20 SCHM - select channel 

Allows a PP to request the best channel for a multi-channel device. See paragraph 7.5 
page 7-10. 
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21 RSTM - request storage 
This function allows a PP routine to change the FX at a CP. The request is the amount of 
FL desired at the CP. If the request is for the same amount of FL or less already assigned 
at the CP, then the request is honored immediately. If the request is for an increase, 
storage moves may be necessary. Control is returned immediately in any case. If a PP 
wishes to reduce FL it should make this request. If it wishes to increase FL it should not 
make the request. It should place the FL increase required in FCLW word 60 byte 4. 
lSJwill then schedule the increase on a priority basis. If a PP makes its own increase 
storage request with this function directly, it could seriously affect scheduling. The PP 
programmer should use the common routine COMPRSI to make increase storage requests. 

22 RSYM - request system 
TMs is the same as RCHM except that a system device is desired. See paragraph 7.S 
p. 7-8. It is used to get a system device which is on the first available channel. 

23 SMSM - set monitor step 
This function is only accepted from DSD, any other PP will be hung. When the operator 
types in STEP or UNSTEP, DSD will issue this function. STEP mode forces MTR to accept 
only 1 function at a time under direction of DSD, see STPM. MTR will step CPUMTR and 
control the processing of those functions , see SMSF. DSD can specify to step system or 
only one CP. MTR will reissue all CPUMTR functions that were stepped when an unstep 
is issued from DSD. 

24 STPM - step monitor 
Ihis function is only accepted from DSD, from any other PP it will be treated as a NOOP. 
(At a future data, this will result in a hang). When the operator hits the space bar, DSD 
will issue this request and then MTR will process one function, which may be to tell 
CPUMTR to process that function if it's a CPUMTR function. 

25 TGPM - TELEX get POT 
This is used to get a POT chain from TELEX. It is useful because the PP does not need to 
interrupt or start up TELEX for the request. See paragraph 13.3.2 monitor request queries. 

26 TSEM - process TELEX request 
Used to request various procedures from TELEX. See paragraph 13.3.2 monitor request 
queues . 

27 DEPM - disk error processor 
Used for MS error processing. See figure 7-10. 
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30 DRCM - driver recall CPU 

Used to issue an RCLM if the CP is in periodic recall status. This function allows the 
PP to ask monitor to determine the CP status than do it itself. This request does not 
require an exchange jump, therefore the PP needs only to place the request in its OR and 
does not need to wait for it to be processed. This is critical for MS or tape drivers, who 
could loose a revolution or tape speed if it needed to wait for a CPUMTR request. However, 
the routine must wait for OR clear before again issuing this function. This is why MS 
error processors must wait for OR clear. 

31 SCPM - select CPUs allowable for job execution. 

10 any CPU 
1 CPUD only 
2 CPU1 only 

32 EATM - enter-access system event table 

Enter or read events to or from system event table. See paragraph 5.2.10. 

3.1.1.1 CPUMTR Functions 

36 ABTM - abort CP 

Exactly that, abort the CP to which this PP is assigned. It sets PPET error flag and 
performs a DPPM. 

37 CCAM - change CP assignment 

Used to change the CP assignment for this PP. It reduces the PP count in the CP at 
STSW bits 52-48 in the OLD CP assignment, and increases it by 1 for the NEW CP 
assignment. 

40 CEFM - change error flag 

Replaces bits 36-47 in STSW word 20 of CPA. It's used to set or clear the error flag. 

41 DCPM - drop CPU from CP 

If CP is in "W" status it is placed in zero status. Note, since there is PP activity the 
CP will not be advanced. 

42 DJSM - disable job scheduler 

When a PP desires to do an activity which can affect the scheduler or in which the 
scheduler can affect it seriously, then it is desirable to disable 1ST. For example, on 
the PURGE DSD command, IDS will attempt to purge some file from a queue (input, 
output, or rollout). If 1SJ attempts to schedule that job while IDS attempts to purge it, 
problems can occur. 
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When a PP issues the DJSM function it receives return status stating: 

1. IS J is active 

2. function accepted 

In the case of 1 , the PP needs to reissue the function. 

In the case of 3, CPUMTRwill note which PP issued the DJSM and will ignore all RSJM 
functions from other PPS. {They will not be hung but will be returned as if the function 
was accepted, i.e., RSJM will be treated as a NOOP). Multiple PP's can disable 1SJ at the 
same. However, all of them must issue an RSJM before 1SJ can be reenabled. 

When the PP which issued the DJSM, finally issues an RSJM, then this RSJM and any 
others will be accepted and processed. Thus, one PP routine can disable lSJby DSJM 
and reenable it with the RSJM. 

43 DTKM - drop tracks 

Tnis is executed in PM. Used to drop trailing tracks from a track chain. See paragraph 
7.5 p. 7-8. 

44 DPPM - drop PP 

This is the last function issued before a PP Jumps to its idle loop. It signifies that this 
PP routine is done and the PP is available for other assignments. 

45 ECSM - ECS transfer 

Used to get 101B words transferred from ECS to/from the ECS/PP BUFFER. 

46 RCLM - recall CPU 

Used to change the CP status from periodic recall to CPU candidate, i.e. "X" status to 
"W" status. 

47 RCPM - request CPU 

Used to start the CPU for this CP and set the CP status = "W". See STSW word 20 in 
CPAbyteO. 

50 RDCM - request data conversion 

Used to convert 30 bit integer to F10.3 display code format 

51 REWM - read ECS word 

Used to transfer one ECS word to the MB. 

52 RJAM - request job accounting 

Convert accounting information in CPA to F10.3 display code. Accounting information 
begins at ACTW and its length is an assembly constant. At level -6, the length is 5, so 
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words ACTW thru ACTWE, words 50 thru 54 in CPA are converted. It converts the lower 30 
. bits to F10. 3 format for transfer to dayfile. 1CI is the only routine using it. 1CJ must 
write this information on the users dayflle* 

53 RPPM - request PPU 

Used to start a PP routine in some other PPU. The response indicates whether the PP 
was assigned or none available. A PP can read PPAL and determine in advance if a PP is 
available. This will save time and overhead. 

54 RSJM - request job scheduler 

See DJSM and 6.1 1ST P. 6-1 and ]SCL word 40 or CMR. This function is used to interlock 
scheduler calls, so that only one copy of 1ST is running at one time in the system. 

55 RTCM - request track chain 

This is executed in PM. This allows the PP routine to request a specified number of 
sectors and reserve the proper track chain. 

56 SFBM - set file busy 

Used to interlock the FNT/FST entry for a specific file. A PP will issue this function 
to reserve the file and when done releases the file itself by setting bit of the FST to one. 
SFBM will set bit of the FST to zero. This function can be used to interlock any word 
in CM, such as PFNL, or any word in the MST. If SFBM is issued for an FNT/FST, the 
filename word must also be provided to check that another PP has not dropped the file Just 
after the PP issuing SFBM found it. Note, in both the FST and the FET if bit is set, the 
file is NOT busy. 

57 STBM - set track bit 

This is executed in MM unless SYSTEM C? is active, then it's done in PM. Used to set 
the w, d, or i bits in the TRT. See paragraph 7.2 p. 7-3. 

60 UADM - update accouting and drop 

Used to interlock any counter in the CPA. The CPA word specified is incremented by one. 
If no word is specified the PP activity count in STSW is incremented by 1 . This is the 
pseudo activity count at a CP. It Is used mainly for tape Jobs so the job cannot be 
completed or advanced, but it can be rolled out. See STSW figure 2-3. 

61 WEWM - write ECS word 

Used to transfer one word from the MB to ECS. 
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62 JACM - job advancement control 

Options 1, 2, 3, 4 are used to set or clear the job advancement flag at a CP with implied 
DPPM if desired. PP routines should not call 1AJ directly for job advancement. MTR will 
decide when a job needs to be advanced and will issue JACM option 5 to call 1AJ to the job. 
1AI then decides if the CP needs advancement or rollout. 

S3 DLKM - delink tracks 

This is executed in PM. DLKM is used to drop intervening tracks on an existing file 

chain and relink the file chain properly. An excellent example would be PFM delinking 

his indirect (IPF) file chain in response to some user issuing a PURGE on some IPF which 

is long enough to completely cover several tracks. PFM attempts to keep his IPF file 

chain to a minimum size when possible. The CPUMTR DOCUMENT description is as 

follows (correction ident CI = CPUMTR 2974 level 4): 

DLKM - DELINK TRACKS. 

ENTRY 

OR 12/ DLKM, 12/ EQ,12/ FT, 12/ NT, 12/ LT 
EO EQUIPMENT NUMBER 

FT TRACK ONTO WHICH NT IS LINKED. 

NT TRACK TO BE LINKED TO FT. 

LT LAST TRACK IN CHAIN TO DROP. 

BIT 11 OF FT MUST BE CLEAR 

ALL TRACKS FROM FT (NOT INCLUDING FT) TO LT ARE RELEASED 

NT IS LINKED TO FT. 

The instant manual description is: 

63 DELINK TRACKS DLKM 

REQUEST: OR 0063 00 eq ffff nnnn 1111 

CPUMTR terms - Instant terms eq Equipment number 

Track onto which nnnn is linked (bit 11 of ffff 
must be clear) 



Instant terms 


eq 


FT=ffff 


ffff 


NT=nnnn 


nnnn 


LT=1111 


1111 



Track to be linked to ffff 
Last track in chain to drop 
REPLY: OR 0000 0000 0000 0000 0000 

NOTE: DLKM will drop all tracks starting at the track linked to by FT and ending and 
including track LT. Track FT will be linked to track NT. If track LT did not link to 
track NT previously, we have a serious condition. See example b. 
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a . As an example let' s say we have a track chain of 7 tracks linked in the following 
manner. 12 — «M — ■»!() — »-15 — »>22 — »11— »20 with EOI in sector 16. Then the 
TRT will be: 










1 


J 


* 




' 












401Q 


4 




5 


J 


6 




7 












4015 


10 


4020 


11 


1 4004 - 


12 




13 














14 


4022 


15 




16 




17 












0016 


20 




21 


| 4011: 


22 




23 













Suppose we wish to delink this chain by eliminating tracks 10, 15, 22 and 11 and 
relink track 4 — ^20. Hence, BEFORE: 



12— »4 — »40 — »«15— *>22- 

t 
ffff 1111 nhnn 

FT LT NT 



-11 — *-20 
i t 



OR=DLKM OOeq ffff nnnn 1111 
0063 00 eq 0004 0020 0011 



AFTER: 12- 



►20 



The TRT will be: 










1 




2 




3 
















4020 


4 




5 




6 




7 


















10 




11 


4004 


12 




13 
















14 




15 




16 




17 
















0016 


20 




21 




22 




23 
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b. Suppose we specified the call incorrectly 

OR = 0063 OOeq 0004 0020 0022 

then we have the following problem: 

BEFORE: 12— »-4 — ••10— *-15— +»22— -*-ll— *-20 

t t T 

ffff 1111 nnnn 

AFTER: 12— »■ 4 — »-20 but also 11 — »-20 

and track 11 is not part of this chain or any other chain. There is obviously a 

problem and at this time it is not known whether CPUMTR will diagnose this 

problem. 

64 TDAM - transfer data to/from Job - from/to MB 

Allows a PP to transfer up to 6 words from/to MB - from/to a job. The address to transfer 
to/from is a relative address. The transfer must be to/from a subsystem. It alleviates the 
problem of a PP finding the subsystem and deciding if it is ready for reception of data. 
This is equivalent to the SIC/RSB facility except no inter CP communication area is 
necessary. See paragraph 5.3.6. p. 5-44. The real problem is being at one CP, and 
needing to write data at another without it being moved during the write. 

65 TIOM - tape I/O processor 

This function updates the tape accounting information, i.e. number of blocks transferred 
in MTUW word 53 of the CPA. Exit from this function is to CCAM to change the PP 
assignment to MAGNETs CP. If the completion code is non-zero, the specified UDT word 
is cleared, the FET is set complete, and the tape activity count is decremented in STSW 
word 20 byte 2. 1MT uses this function when it completes a read/write request on a tape. 
Since the UDT and the FET must be changed, and they are in two different CPs, this 
function prevents any problem by keeping the CP & MAGNET from interfering with each 
other. UDT must be cleared before FET is set complete or an I/O sequence error could 
occur. The problem again is storage move at one CP while attempting to write to it. 

66 RTLM - request CPU time limit 

Used to change the CPU time limit in CTLW word 20, byte 2, 3, and 4 in the CPA. The 
time limit exceeded flag in ACTW word 50 byte is cleared . 

67 LCEM - load central program 

This is executed in PM. Used to load an ECS or CM resident routine into the CPs FL. 
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Used to clear a specified contiguious amount of CM. Memory is cleared backwards, 
i.e. address is LWA to clear. 

71 CKSM - checksum a specified area 

Checksum area from FWA to LWA+1 and compare to checksum in MB. 

74 MXFN - maximum function number 

This is used by a PP when it desires to hang itself for some reason it considers 

catastrophic. CPUMffR will see that it is out of range and will hang the PP. 

NOTES on hanging PPs: 

A PP is hung when one of the monitors determines that a function is illegal, e.g. function 

out of range, RCHM on some non existant channel, etc. If CPUMTR hangs a PP the 

U.G90<a*4<= . 1 UUHU Ai3 M^O ^-LU / OM Ul tire O/SLCUl V i • 

If MTR. hangs a PP the message is "HUNG PP". 

In any case the packed date and time of the hang is placed in MB+5. 

3.1.1.2 MTR functions to CPUMTR . 

These are special functions and the request is transmitted via the XO register instead of 
MTRs OR. 

FUNCTION NUMBER 

no name 



entry (XO) = 

exit none. 

This function tells CPUMTR that some CP has an RA+1 request. This is used for systems 

where the XJ is not available or the user's program is not doing an XJ. 

advance running times 

42 18 



ARTF 



entry (XO) = 

exit none. 

Update running times. Updates RTCL in CMR and ACTW in CPA and set time limit exceeded 

flag if time limit has been exceeded. It also checks for P = and program stop. MTR 

checks active CPs and if the P does not change, MTR looks at the instruction P points to. 
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If the top parcel (top 15 bits) is zero, it is a PS and MTR calls CPUMTR with this function 
to register the error. If the PS is not in the 1st parcel, then the CP will not be interrupted 
by MTR and it will stop only on time limit error or operator drop. 



18 






CPA FWA 


IARF 



IARF initiate auto recall 

24 
entry (XO) = 

exit none. 

MTR while in the routine PPL, process PP recalls, will check RA+1 of a CP in auto recall 
and if RA+1 set with auto recall requested, it will reissue the PP request. See PPL in 
chapter 3. 

If a PP routine finds that it cannot process the request it was called for at this time, it can 
copy its IR back to RA+1 if the CP is in "R" status. When MTR goes thru its PPL routine 
it will find the request and have CPUMTR reissue it to a PP. 

MSTF move storage 







42 




18 




entry (XO) = 









MSTF 






12 


30 18 


(SMRR) = 


IN/100 





. CFA FWA 




where IN = ■ 


r or 


- number 


of words to move the C 


p 


exit (SMRR) 








This function asks CPUMTR to move a CPs entire FL up or down in CM the specified number 
of words. CPUMTR can get the original RA from the STSW word. SMRR is a local word in 
CPUMTR. 



MRAF modify RA 



12 



12 



18 



18 



entry (XO) = | IN/100 | [ CPA FWA | MRAF 



where IN = + or - value to change RA. 

exit none. 

CPUMTR will change RA in STSW and EP by the specified amount. 

MFLF modify FL 



12 


12 


18 


18 


IN/100 





CPA FWA 


MFLF 



entry (XO) 
exit none. 
CPUMTR will change FL in STSW and EP by the specified amount. 
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11 



SCSF set (restore) CPU status 

12 12 

entry (XO) = 



18 



STATUS 





CPA 

FWA 


SCSF 



exit none. 

CPtTMTR will place the specified status in the STSW word. This is used when MTR issues 
the DCPM function. The status is returned to MTR for safe keeping. When MTR is ready 
to restart the CPU it will issue this function restoring the former status. 

Functions- MSTF, MRAF, and SCSF may all be used when a CP needs to have its FL changed 
via the RSTM function. If MTR has to move the CP, it will issue the DCPM and save the 
status, then issue the MSTF for the move. Note that MSTF will update the RA and FL. If 
no storage move is required, then the MRAF and/or MSTF will be used. 

Finally, it issues SCSF to restore the former status. Note, when a CP is going to be 
moved, the only criterion for that move is no PP activity, so the CP could be in any status 
when MTR is ready to make the move, and after the move,' the proper status must be 
restored. 

SMSF set monitor step 

42 IS 



SMSF 



entry (XO) = 

exit none. 

This tells CPUMTR to disable his automatic processing of monitor functions and to wait for 

MTR to indicate which function to process. Interaction is accomplished via the DXP and 

DXJ stuff in CPUMTR. See figure 3-7. SMSF and CMSF are used when the system is 

placed in STEP mode. See SMSM and STPM. 

10 CMSF clear monitor step 



42 


18 





CMSF 



entry (XO) 
exit none. 
Re-enable automatic processing of monitor functions. 



18 



CAEF check arithmetic error 

24 18 

entry (XO) 

exit none. 

CPUMTR will check (P) , if zero, it gets the error flag in STSW to ARET=2, arithmetic error. 



CPA FWA CAEF 
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12 ACS M advance CPU Job switch 

24 18 18 

entry (XO) = | | CPA FWA 



ACSF 



exit none. 

Used to change the CP assignment of the CPU. It is used in the MTR routine JSW, process 
CPU job switching, to exchange the CPU from one CP to another, which is slot time 
exceeded processing. 

13 PCXF process CPU exchange request 

42 18 

entry (XO) = 







PCXF 



exit none. 

If CPUMTR is executing in one of the CPUs and needs to be in the other CPU it will tell 
MTR of its plight via some interaction word and XJ. MTR will then issue this request to 
the other CPU. This is done in the AVC advance clock routine, which is the one section 
of MTR that must execute at least every 4 milliseconds. For example, ABTM. PPR 
doesn't know which CPU its CP is in, so it starts CPUMTR up in CPUO. If the CP to be 
aborted is in CPU1 , then CPUMTR must get itself into CPU1 and that CP out of CPU1 . 

MTR processes Pool PP OR requests as follows. 

If the CEJ/MEJ is not available or disabled, then MTR will check all OR requests. If a 

request is for CPUMTR, MTR will jump to its routine CPR. CPR will exchange in CPUMTR 

for that PP. 

If the CEJ/MEJ is available, MTR will ignore any CPUMTR request, since the PP must 

issue its own MXN, i*e., CPUO cannot stop CPU1, so the PCXF alternate exchange 

request is made. 
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3. 2 EXCHANGE JUMPS 

An installation may make use of the optional hardware instructions MXN (monitor exchange) 
and XJ (exchange jump) or EXN (exchange). KRONOS 2. 1 requires either the combination of 
MXN/XJ or EXN. 

Exchange jumps use an exchange package as shown in Figure 3-5. A general description of 
this package is contained in Section 2. 



n 

n+2 

n+3 

n+4 

n+5 

n+6 

n+7 

n+10 

n+11 

n+12 

n+13 

n+14 

n+15 

n+16 

n+17 



. 59 



53 



35 




RA CM 



FLcm 



EM 



RA ECS 



FL ECS 




AO 



Al 



A2 



A3 



A4 



A5 



A6 



A7 



XO 



XI 



X2 



X3 



X4 



X5 



X6 



X7 



17 



BO 



Bl 



B2 



B3 



B4 



B5 



B6 



B7 



i 9 
i 10 



11 
12 
13 

14 
15 



Figure 3-5. Exchange Package 

3.2. 1 Control Data 6400/6500 Systems Central Processor Monitor 

In Control Data 6400/6500 computer systems, system functions are normally handled by the 



UlUUl.l,IJi IVv 



A1.0U IlJ 
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with certain hardware capabilities to effectively implement monitor activities in the central 
processor. Since the central processor can reference extended core storage directly for 
service routines, programs, and data, a central processor monitor program to handle 
these and other functions is faster and more efficient than a monitor residing in a peripheral 
processor. 
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The hardware elements of the 6400/6500 system which provide the essential capabilities for 
implementing a central processor monitor are described in the ensuing paragraphs. 

3, 2, 2 Monitor Address Register (MA) 

Contained in the exchange jump package (bits 36-53 of location "n+6") is an 18-bit monitor 
address. Just as other central nrocessor operational registers are loaded during an exchange 
operation, so is the monitor address register loaded with the 18 -bit monitor address. This 
monitor address is the starting address of the exchange package for an ensuing central 
exchange jump instruction (except when the monitor flag bit is set; refer to the instruction 
description). 

3.2.3 Monitor Flag Bit 

The Central processor has, in the central memory control section of the system, a monitor 
flag bit. A master clear (dead start) clears the monitor flag bit. Any action thereafter on 
this bit is via the monitor exchange or the central exchange jump instructions. (There is 
no instruction with which to sample the status of this bit directly and/ or independently of 
these instructions. ) The operation of this monitor flag bit is described under the instruction 
descriptions. 



Mode 

Monitor Mode 
Program Mode 



Flag Bit 

1 




CPU 

Not interruptable 
Interruptable 



3. 2.4 Central and Monitor Exchange Jump Instructions 

With the CEJ/MEJ option two instructions exist for central processor monitor implementa- 
tion. The first, XJ, executable by the central processor and the second, MXN, executable 
by the peripheral processors. These instructions are as detailed below. 

3. 2.4. 1 Central Processor 



code 



mnemonic 



013 XJ Bj+k 



description 

Central Exchange Jump (60 bits) 



CPU Memory Layout 



code 


J 


K 


not used 



59 



51 50 



48 47 



30 29 
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This instruction unconditionally exchange jumps the central processor, regardless of the 
state of the monitor flag bit. The instruction action differs, however, depending on whether 
the monitor flag is set or clear. Operation is as follows: 

• Monitor Flag bit clear 

The starting address for the exchange is taken from the 18 -bit monitor address 
register. Note that this starting address is an absolute address. During the 
exchange, the monitor flag bit is set. 

• Monitor Flag bit set 

The starting address for the exchange is the 18 -bit result formed by adding K 
to the contents of register Bj. Note that this starting address is an absolute 
address. During the exchange, the monitor flag bit is cleared. 

3.2.4.2 Peripheral Processors 

code mnemonic description 

261 MXN d Monitor Exchange Jump (12 bits) 

PP Memory Instruction Layout 



Code 
Yl "" 1 a= \l exchange to CPU1 



, f'o exchange to CPUO 



This instruction, typically used to initiate central processor monitor activity, is a condi- 
tional exchange jump to the central processor. If the monitor flag bit is clear, this instruc- 
tion sets the flag and initiates the exchange. If the monitor flag bit is set, this instruction 
acts as a pass instruction. • The starting address for this exchange is the 18 -bit address 
held in the peripheral processor A register. (The peripheral processor program must 
have loaded A with an appropriate address prior to executing this instruction. ) Note that 
this starting address is an absolute address. 

3.2.4.3 EXN 

In an installation without the MXN/XJ instruction set, the EXN is the only exchange instruc- 
tion available. It is a PP initiated exchange jump which occurs independently of the mode of 
the CPU and has no effect on the CPU mode. MTR is the only PP program that may perform 
an EXN; it must simulate the MXN for all PPs in the system and simulate XJ for the central 
processor. When MTR detects a request for CPUMTR in a PP output register, it will EXN 
to the exchange package for the pool PP which desires the excahnge jump. 

code mnemonic description 

260 EXN Normal Exchange Jump 
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as MXN. 
3,2.5 Programming Notes 






NOTE 1 

PP memory instruction layout is the same I 

as MXN. I 



1) Note that any exchange (260, 261 or 013) to the exchange package will load the contents 
of location "n+6" into the monitor address register (other operational registers are 
similarly loaded). Thus, any ensuing 013 instruction using the contents of the monitor 
address register as a starting address uses those contents as loaded. 

2) The exchange packages for entering the central processor monitor should usually have 
the Reference Address (RA) equal to 000000 and the Field Length (FL) equal to central 
memory size. 

3) Since the monitor flag bit cannot be directly sampled, a program cannot directly deter- 
mine its state; hence, success in performing a peripheral processor monitor exchange 
cannot readily be predicted. Further, program control always is given to the next 
instruction, whether or not the exchange is honored. A method of determining whether 
the monitor exchange occurred is as follows: 

Table 3-4 summarizes the operational differences between the normal exchange jump in- 
struction (260) and the monitor and central exchange jumps (261 and 013). 
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TABLE 3-4. EXCHANGE INSTRUCTION DIFFERENCES 



r 



No 
CEJ/MEJ < 



With , 

CEJ/MEJ •< 







Operational Differences 


Effect on 


FWA of 




Conditional/ 


M onitor 


Exchange 


Instruction 


Unconditional 


Flag Bit 


Package in CM 


EXN 


Unconditional 


No effect on flag 


Peripheral 


260 (Normal 






Processor 


Peripheral 






A Register 


Processor 








Exchange 








Jump) 








MXN 


Conditional 


Sets flag 


Peripheral 


261 


(occurs only 




Processor 


(Peripheral 


if Monitor 




A Register 


Processor 


Flag bit is 






Monitor 


clear; passes 






Exchange 


if flag is set) 






Jump) MXN 








XJ 


Unconditional 


Sets flag 


Central 


013 (Central . 






Processor 


Exchange 






Monitor Address 


Jump) with 






Register 


Monitor Flag 








Bit clear 








XJ K+(B i ) 
013 J 


Unconditional 


Clears flag 


Address formed 






by K+(Bj) 


(Central 


■ 




Exchange 








Jump) with 








Monitor Flag 








Bit set 









a) Set BO (bits 0-17 of location "n") in the exchange package to 7777. 

b) Initiate the monitor exchange (261). 

c) Read BO from the exchange package in central memory. If the monitor exchange 
was honored, BO in the exchange package will equal 000000. If the instruction 
passed, this location still holds 7777. 

4) Different exchange packages should be used for central processor exchanges and periph- 
eral processor exchanges. This aids software determination of which of two jumps 
(central or monitor exchange jumps) was executed when both were initiated at approxi- 
mately the same time. 

5) Simultaneous exchange requests are resolved in favor of the central processor. 
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6) If either a 260 or 261 instruction is waiting to be honored when the central processor 
issues a 013jk instruction, the 013 instruction is not executed and the peripheral 
processor exchange occurs. When control is returned to the exchanged program (the 
interrupted program containing the 013jk instruction), the 013jk instruction is re- 
issued and executed. 

7) The state of the monitor flag bit has no effect on the operation of the normal PP 
exchange jump (260); nor has this instruction any effect on the flag. 

In addition, there may be CPUMTR requests which require more CPU time than it is feasible 
for CPUMTR to use in monitor mode and still ensure smooth system flow. For these 
requests, such as DTKM (drop tracks), the CPUMTR will queue them at the system control 
point and exchange jump to this control point. The system CP operates in program mode 
and is treated as any other user program. If the system CP is interrupted with another 
long request, the request is placed in the system CP queue and the system CP is restarted. 
The system control point can be interrupted by any MXN from a PP. However, because its 
CPU priority is the highest in the system (100), it will always get the CPU back immediately. 
No other control point will get the CPU if the system control points wants it. 

Figure 3-6 shows all the system exchange packages and the entry points into CPUMTR. 
Table 3-5 shows the correspondence between CP, CP address, and the exchange package 
MA for a system configured to have 17B control points | 

Note that each PPU has its own exchange package in CMR. The system CP and each normal 
CP has its own exchange package in CMR in the control point area. 

A CP will always have (MA)= its exchange package address. Additional exchange packages 
are provided for the two idle routines, subcontrol points, disabled central exchange, return 
package, disabled central exchange program, and a simulated exchange exit to monitor 
mode. These packages are generated at the end of the CPUMTR code. 



Note that PP0, MTR's exchange package, is not contiguous with the other PP exchange 
packages. 

Figures 3-7 and 3-8 show the generation of these EPs in the CPUMTR listing. Note that if 
the machine has only one CPU, only one idle package is built. If the machine has a CEJ/ 
MEJ option enabled, the DXP, DXJ, and SXJ package is not assembled. 

3. 3 FLOW OF EXCHANGES 

The flow of exchanges (there are only four distinct types) are illustrated and explained in 
flow diagrams Figure 3-9 through Figure 3-12. 
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TABLE 3-5. CORRESPONDENCE BETWEEN CP, CP/ADDRESS, AND THE 
EXCHANGE PACKAGE MA IN A SYSTEM CONFIGURED TO 
HAVE 17B CPs 



Control Point 


Address 


Xchg Pkg MA - 


-1 


200 


200 


2 


400 


400 


3 


600 


600 


4 


1000 


1000 


5 


1200 


1200 


6 


1400 


1400 


7 


1600 


1600 


10 


2000 


2000 


11 


2200 


2200 


12 


2400 


2400 


13 


2600 


2600 


14 


3000 


3000 


15 


3200 


3200 


16 


3400 


3400 


17 


3600 


3600 


20 (SYSTEM) 


4000 


4000 
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SYSTSM EXCHANGE PACKAGES 





PPUs*2 


PFMTR 


Control Point 

N+l 


C ontrol 
Points 

1— N 


Sub -control 
Points and Idle 
Programs 


^Graphic 
repre- 
sentation 


OVT> DTDTT 

A- AAA J. -L \J 

(PP1) Ex- 
change 
Package 

PPU(PPn) 

Exchange 

Package 


j/vp PPMTR 
Exchange 
Package 
(PPO) 


S1£P System 
Control Point 
(n+l) Exchange 
Package 


2Q0B 
Control 
Point 1 

Exchange 
Package 

N*200B 
Control 
Point n 
Exchange 
Package 


SCX Sub CP 
EP1 

SCX1 Sub CP 

EP2 

IXP IDLE 
CPUO 

IXP1 IDLE 
CPU1 


Signifi- 
cant 
Contents 


P=PPR 

MA=zero 

B2=»ddress 

of PPi EP 

(PJff+ft-l) 

*21B)" 


P=PMN 

MA=2ero 

B2=MXP 


P=PRG 
MA 'System 

Control 

Point 

Area 

Address 
=SXP 


P=CP Prog 
P address 
MA= This 

Control 

Point 

Area 

Address 
=addr. of 
CPiXJPKG 
[ i*200B ] 


Sub CP P=MTR 
MA=SCX, SCX1 
B2=SCX,SCX1 
IDLE P=idle 
Loop Address 
(IDL, IDL1) 
See 3-58 
MA=IXP, IXP1 


Size, 

Numbers 
and , 
Location 


21 words per 
package. Up to 
19 packages. 
These-start at 
end of CPUMTR 
code *1 


20 words for 
this package. 
This is at the 
end of 
CPUMTR 


First 20 
of system 
control point 
area in 
CMR 


First 20 
words of 
each control 
point area 
in CMR 


20 words for 
each package. 
These are at 
end of 
CPUMTR. 

1 


Symbolic 
address 


CPUMTR 

address 

PXP 


CPUMTR 

address 

MXP 


CPUMTR 

address 

SXP 


200B 
400B 

N*200B 


CPUMTR address' 
SCX and IXP 
SCX1 IXP1 

i 



*1 Th« 2-1B- word* spaces the packages so that no bank conflicts will arise when PPs aceess 

them on 6SK systems. 
*2 PRS of CPUMTR will dynamically set up either 9 or 19 packages at D/S depending on the 

hardware . 

Figure 3-6. System Exchange Packages 
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CPUMTR - CPU MONITOR. 
EXCHANGE PACKAGES. 



COMPASS 3.73130 



73/08/01. 10.20.58. 
MONITOR 



1763 

EXP is a macro which 

generates an exchange 

package. 



QUAL MONITOR 

MXP - PPU MONITOR EXCHANGE PACKAGE. PP0 

" MXP^^^^EXp)- P=PMN.FL=(,MCM).FLX = <.MEb, Bl = l f B2=MXP 

:„u — — ' 



2003 
2023 

2043 
2063 

2103 



sex 



tXP 

IXP1 

* * 

DXP 



2123 0130002103 + DXJ 

2124 36550 

0200002123 + 

* * 



2125 5160000075 SXJ 
0200000076 



SCX - SUB-CONTROL POINT EXCHANGE PACKAGES. 



EXP P=MTR,FL=(, MCM),FLX = (,MEC). B1 = 1,B2=SCX 

SCX1 EXP P=MTR,FL=(.MCM),FLX=(,MEC),B1 = 1.B2=SCX1,A0=1 
* * EXP - IDLE EXCHANGE PACKAGES. 



EXP P-2, RA = /PROGRAM/IOL,FL=3,MA = IXP 

EXP P = 2, RA = /PROGRAM/IDLl,FL=3,MA = IXPl 

DXP - DISABLED CENTRAL EXCHANGE RETURN PACKAGE. 



EXP P=DXJ+t,FL=(.MCM),X0=l 

DXJ - DISABLED CENTRA L EXCHANGE PROGRAM. 



XJ DXP RETURN TO CALLER 
1X5 X5+X0 COUNT EXCHANGE 
JP DXJ 

SXJ - SIMULATED EXCHANGE EXIT TO PROGRAM MODE. 



SA6 MR SET EXCHANGE ADDRESS 
JP MR+1 EXIT TO WAIT FOR *MTR* 
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CPUMTR 


4904 


CPUMTR 


4906 


CPUMTR 


4907 


CPUMTR 


4908 


CPUMTR 


4909 


CPUMTR 


4911 


CPUMTR 


4912 


CPUMTR 


4913 


CPUMTR 


4914 


CPUMTR 


4915 


CPUMTR 


4916 


CPUMTR 


4918 


CPUMTR 


4919 


CPUMTR 


4920 


CPUMTR 


4921 


CPUMTR 


4922 


CPUMTR 


4923 


CPUMTR 


4925 


CPUMTR 


4926 


CPUMTR 


4927 


CPUMTR 


4928 


CPUMTR 


4930 


CPUMTR 


4931 


CPUMTR 
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CPUMTR 


4933 


CPUMTR 


4934 


CPUMTR 


4935 


CPUMTR 


4937 


CPUMTR 
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CPUMTR 


4939 


CPUMTR 


4940 


CPUMTR 


4941 


CPUMTR 


4942 
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Figure 3-7. Part 1 - Exchange Packages Defined 
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CPUMTR - CPU MONITOR. 
EXCHANGE PACKAGES. 



2126 



SXJL 



2126 



2C52 



2672 



524 



PXP 



SXP 



COMPASS 3. 73130 73/08/01. 10.20.58. 
SXJ MONITOR 



BSS 



PXP - PPU EXCHANGE PACKAGE. 

COPIED ONCE FOR EACH PPU. 

(A5) = PPU OUTPUT REGISTER ADDRESS. 

BSS 20*2113 SPACE FOjySlT pPUS ) IF NEEDED 

(Never more than 19 used since PP0 is not 
defined here. ) 

EXP P = PPR.FL=(,MCM),FLX=(,MEC),B1 = 1. B2 = PXP 

SXP - SYSTEM JOB EXCHANGE PACKAGE. 
COPIED TO SYSTEM CONTROL POINT. 



EXP P=/PROGRAM/PRG,FL==(,MCM),FIX=(,MEC), 
MA=(,SCA), Bl=l 
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Figure 3-8. Part 2 - Exchange Packages Defined 



CO 

I 

CD 



3.3.1 Pool PPU Request 

Assume the CPU is active with CPn and MF=0. If MF=1, then the exchange will not take 
place. PPn will build a CPUMTR EP in its EPA. 



CPAn 



CPUMTR 

EP 
(P)=MTR 



EPA FWA 
MF=0 



Same as above 

No 

Change 



Same as above 
No 
Change 



PPn EPA 




CPUMTR 
EP 

(P)=PPR 
(B2)=EPA FWA 



CPn 

EP 

Addrs of 

(P)=Next Instr. 



CPUMTR 

EP 
(P)=MTR 



1. PP sets word 
zero of EP. 
(P)=PPR, (BO)jfO 
(B2) = EP address 
for the PP issuing 
MXN. 

2. CPUMTR starts 
execu+ing at PPR. 
When complete, 

it issues XJ B2 

3. <P)=MTR since 
this location 
follows MTRX in 
CPUMTR. The 
next time this PP 
calls CPUMTR, 

it will reset 
(P)=PPR. 



Figure 3-9. Pool PPU Request 



NOTE: If the PP function requires a response in its OR (output register), 
CPUMTR will exit to MTRP which will fall into MTRX. If no response is 
required, CPUMTR wiU exit to MTRX. MTRX is just an XJ B2. MTR 
follows MTRX; therefore, after the exchange, (P)=MTR in the CPUMTR 
and EP in the PPn EPA. Refer to Figures 3-4 and 3-40. 

3.3.2 PPMTR Request 

This is the same as the pool PP request except that (P)=PMN and (X0)=request in the MTR EPA. 
CPAn 



CPUMTR 

EP 
(P)=MTR 



Same as above 

No 

Change 



Same as above 

No 

Change 



MTR EP FWA 
MF = 




MTR EP 



CPUMTR 

EP 

(P)=PMN 

(B2)=MTR EPA FWA 

(X0)=Request 



CPn 

EP 

Addrs of (P)= 

Next Instr. 



CPUMTR 

EP 
(P)=MTR 



1. MTR sets up 
P, BO, B2. The 
request is stored 
in (X0) and the 
MTR issues MXN. 

2. CPUMTR starts 
executing at PMN 
and exits at 

MTRX 

3. Same as pool PP. 
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The following figure graphically shows the relationships of the monitors , poll PPs , and CPs ■ 
Figures 3-11, 3-12, 3-13, and 3-14 shows the 4 types of exchanges in detail. 



Type 
of 
Exchange WHO does 


WHAT to 


WHOM, 


WHEN, 


WHY and 


WHERE 


for which 

final 
DISPOSITION 


3 CP Prog 


request 


CPUMTR 


whenever 


need help 


RA+1 


CPUMTR/PP 


4 System Prog, 


request 


CPUMTR 


time to quit 


to end 


PX 


CPUMTR 


1&2 Pool PPs/MTR 


request 


CPUMTR 


whenever 


need help 
or inter- 
lock 
function 
35-71. 


OR 


CPUMTR/PP 


Pool PPs 


request 


MTR 


whenever 


need help 
or inter- 
lock 
function 
1-34. 


OR 


MTR 


2 MTR 


spec, 
request 


CPUMTR 


whenever 


need help 


XO in 

EP 


CPUMTR 


There are only 4 types of exchanges 


inKRONOS/NOS. 








1. PoolPP 














2. MTR 














3. CP Prog. 














4 . System CP n+1 















Figure 3-10-1. Relationship of the Monitors, Poll PPs and CPs 
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3.3.3 Program Request 

Since CPn is running in CPU (MF=0), MA=the address of CPn and CPA=EP FWA. 
EP FWA CPAn 



CPUMTR 

EP 

(P)=MTR 

(B2)=EF FWA 



CPnEP 
(P)=Addr of 
Next Instr 

(MA)=EP FWA 



CPUMTR 

EP 

(P)=MTR 

(B2)=EP FWA 




1. CPn places the request 
in RA+1, and will either 
XJ (MA) (where MA is 
the hardware register 
in the CPU), or wait for 
MTR to notice the re- 
quest. 

2. CPUMTR will process 
the RA+1 request and 
(unless recall is re- 
quested) will reactivate 
CPn by XJ B2. 

(Note: (B2HEPFWA) 

3. CPUMTR will exit at 
MTRX which will set 
(P)=MTR in CPn CPA. 



Figure 3-11. Program Request 



3.3.4 System CP Program Mode 

CPAn*! 

SYS EPFWA 



SYS CP EP 
(P)=PRG 
(MA)=SYS EP 
FWA 



CPUMTR 
EP 

(F)=MTR 
(B2)=EP FWA 



SYS CP EP 
(P)=Addr of 
Next Instr 
;'(PRG> 
(MA)=SYS EP 
FWA 




CPn EP 


CPnEP 


(P)=Addr of 


Next Instr 


(MA)=EPFWA 


for CPn 



Same as above 
No 
Change 



Same as above 
No 

Change 



J 



CPn EP 



CPUMTR EP 
(P)=MTR 
<B2)=EP FWA 
for CPn 



CPUMTR will |' 
add this re- 
quest to the 
system CP 
queue. It 
then exits to 
MTRX (which i 
is an XJ), 
thereby sett- 
ing (P)=MTR 
in the EP. 

When the sys - 
tern CP has 
exhausted its 
queue, it will 
XJ (MA) back 
to CPUMTR. 

System Control 
Point has 
finished and 
exchanges to 
CPUMTR. 

CPUMTR will 
now start the 
highest 
priority CPn. 



Figure 3-12. System CP Program Mode 
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NOTE: The SYS CP can be interrupted by a PP 
program. In this case the PPn EPA will 
contain the SYS CP EP of which the (P)= 
address of next instruction to execute 
(not PRG ). 



3. 4 EXAMPLE OF SYSTEM INTERACTION 

A probable sequence of system interaction is illustrated and explained in flow diagrams 
Figure 3-13 through Figure 3-22. 

3. 4. 1 Assume CPUMTR is running in MM, and it decides to activate CP12 (i. e. , give the 
CPU to CP12). 




CP12 CPA 


PTX 
ATX 




CP12 
EP 


CPUMTR EP in CPU 
<MA)=2400 




CP12 CPA" 


CPUMTR issues 


CPUMTR 

EP 


XJ Bj+K ( = 2400) 




CP12 EP in CPU 



Figure 3-13. CPUMTR Running in MM Activates CP12 



3. 4. 2 Assume PP3 asks CPUMTR to perform a function. PP3 must build a CPUMTR EP in 
PP3 EPA. Note -that RA=0, FL= machine field length, and P=PPR, the FWA of CPUMTR PP 
function processor, PP3 will issue MXN. Since MF=0, this exchange will occur. 



PP3 EPA 




2400 



2400 



CPUMTR 
EP 


PTX 
ATX 


CP12 EP in CPU 




PP3 issues MXN 







CPUMTR 
EP 






CPUMTR has 
CPU 



Figure 3-14. PP3 Requesting Function from CPUMTR 
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3.4. 3 Suppose CPUMTR processes the PP request and then determines from CPU priorities 
that CP 14 should be activated. 



PP3 



CP12 
(MA)=CP12 
CPA FWA 
(2400) 



MF = 1 



> -^ C P12 

/ \ 2400 ' 

I CPUMTR) 




CP14 



3000 



CP14 



CP14 



3000 



CP14 EP 



RESTORE 
PP3-eP — 
(MA)=0 



CP14 



CPU eP 



ATX 



RESTORE 

; PP6-EP- 
(MA)=0 



MF=0 



CPUMTR EP 



NOTE: CP14 area may exist from a previous XJ 
by MTR or may have been built due to a 
request by the scheduler or the advance- 
ment routines. Since CP12 will not be 
activated, it is necessary for CPUMTR 
to move CP12 EP from PP3 EPA to CP12 
EPA before issuing XJ Bj+K (=3000). 



Figure 3-15. CPUMTR Processing PP Request Activates CP14 
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3.4.4 Suppose MTR decides to switch CPs (i.e. , stop CP14 and start CP10) and issues an ACSF 
(switch job request) to the CPUMTR. MTR must build a CPUMTR EP in his EPA and issued MXN. 



MTR EPA 



PTX 



ATX 




3000 



3000 



CP14 EP 



CPUMTR 
EP 



Same as 
above 

No 
Change 



CP14 running in CPU 



CPUMTR in CPU 



Figure 3-16. MTR Switches CPs 



3.4.5 Then CPUMTR will activate CP10. MTR decides which CP to start, and CPUMTR 
start it. 



will 



PTX 



ATX 



MTR EPA 



CP14 EP 


<MA)*CP14 


CPA 


FWA = 3000 



Same as above 
No 
Change 



Restored 
MTR EP 
(MA)=0 



Same as above 
No 
Change 



MF = 



CP10 CPA 




Same as 
above 
No 
Change 



CPUMTR 

EP 



CP14 CPA 



3000 



CPUMTR 

EP 



ioofps 



CP14 
EP 



Same as 
above 
No 
Change 



3000 



Same as 
above 

No 
Change 



Copy 

CP14 

EP from 

MTR 

EPA to 

CP14 

CPA. 

CPUMTR 
issues XJ 
Bj+K 

( = 2000) 



Figure 3-17. CPUMTR Activates CP10 
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3,4, 6 Suppose CPIO wishes to call CIO, CPIO places the call in RA+i and issues XJ. 

Since MF=0, the exchange will store the CPU EP value in location (MA). Now, whenever 
CPUMTR built CPIO EP, he set (MA)=2QQQ and (P)=MTR, the FWA of CPUMTR CP request 
processor. 



PTX 



ATX 



CPIO 



CPUMTR 



2000 




MF = 


CPUMTR 
EP 




N^OOO 




CPIO 

EP 


Mr = 1 





RA+1 [CIO j R f FET address] 



RA+1 



NOTE: Now, CPUMTR places CPIO into auto recall, 
calls CIO to a pool processor, say PP6, and 
searches for the highest CPU priority job to 
activate which is CP16. 



PTX 



ATX 



•16 



2000 




MF=0 





3400 
^ s " s \3400 


CP16 CPA 


Same as 
above 

No 
Change 




CP16 

EP 










CPUMTR 
EP 


Same as 
above 

No 
Change 







CPUMTR XJ Bj+K( = 3400) 



Figure 3-18. CP10 calls CIO and CPUMTR, Places CP10 into 
Autorecall, Calls CIO and Activates CP16. 

3.4. 7 Suppose CIO runs to completion, sets the status of its operation to complete, and pre- 
pares to drop. In order to drop, CIO will MXN to monitor with a DPPM (drop PP request). 
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PTX 



EPA FWA 



PP6 EPA 



ATX 



CPUMTR 

EP 
(B2)=PP6 EPA 
FWA 



CP16 

EP 



CPUMTR 

EP 
(B2)=PP6 
EPA FWA 




3400 



CP16 CPA 



CPUMTR 
EP 



3400 




CPUMTR takes 
CP 10 out of auto 
recall and makes • 
it a candidate for 
the CPU. 



CPUMTR XJ Bj+K 
(=Addr of PP6 EPA) 



Interrupted CP16 
continues. 



Figure 3-19. CIO Runs to Completion and MXNs to Monitor 



3. 4. 8 Suppose PP4 issues a DTKM {drop track function) via an MXN. 



PTX 



EPA FWA 



ATX 



PP4 EPA 



CPUMTR 

EP ! MF = 0l CP16 

(B2)=PP4 EPA 
FWA 



CP16 

EP 

(MA)=CP16 

CPA 

FWA (3400) 




3400 



CP16 CPA 



3400 



CPUMTR 
EP 



Same as 
above 
No 
Change 



Figure 3-20. PP4 Issues DTKM Via MXN 
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3, 4, 9 Now PP4 will idle on its OR until monitor satisfies its request, DTKM is a request 
which takes too long a CPU time-3liee, therefore, it is processed by CPUMTR in program 
mode via the system CP. The system CP is treated as any other CP except that it has the 
highest priority. CPUMTR will begin processing this request by queuing the request and 
XJ Bj+k (=4000), thereby activating the system CP. If the system CP is interrupted, 
CPUMTR will process the interrupting request. 

If it is a request which is also processed by the system CP, CPUMTR will queue this re- 
quest and reactivate the system CP. In this way, all these types of requests are handled 
in a first come, first served order. . 

Before the exchange can occur, however, CPUMTR must copy CP16 EP from PP4 EPA. 



PTX 



PP4 EPA 



CP16 

CP 
(MA)=CP16 
CPA FWA 

(3400) 



MF=1 



| CPUMTR) 



CPE6 CPA 4000 System CPA 



■JCPUMTR 
EP 



SYS 
EP 
<P)=PRG 



ATX 



Same as above 

No 

Change 



Restored 
PP4 EP 
(MA)=0 



4000 



Same as above 

No 

Change 



MF=1 



MF = 1 



MF=0/ 



Same as 
above 
No 

Change 




Same as 
above 
No 
Change 



Same as 
above 

No 
Change 



CPUMTR 

EP 
(P)=MTR 



Figure 3-21. System Control Point Processing 
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3. 4. 10 When system CP completes all the requests in his queue, he will XJ (MA) to the 
CPUMTR. 



NOTE: For system CP (MA)= 4000, and CPUMTR will have 
set <P)=MTR in the CPUMTR EP at system CPA. 
When the system CP exchanges, CPUMTR will be- 
gin at MTR. However, the system CP begins 
executing at PRG. 



PTX 4000 



ATX 4000 



CPUMTB 

EP 
(P)=MTR 



SYS CPA 



SYS 
EP 
(P)=PRG 




Now, CPUMTR will pick a CP to activate, and on and on. 

Figure 3-22. System Control Point XJ (MA) to CPUMTR 

3. 5 SUB CONTROL POINTS (SCP) 

The SCP concept can best be thought of as a mini operating system operating with a 
particular CP. The CP user may define a controlling segment — similar to an absolute 
overlay level (0, 0) — as the CP Executive (E). The E can be thought of as a monitor for 
- this CP. Subroutines (similar to absolute overlays) may be defined as subtasks and can 
be run with complete protection from each other. 

The E may time share its CP time slice among a series of subtasks . Since the SCP has its own 
' RA and FL, the E can have a hardware protected CM area. The E, since its RA and FL encompass 

I all of the SCP's FL, may directly oversee and control all the SCPs defined at its CP. The E must 
load the subtask into an SCP.' Since the subtask is a (0.0) overlay, LDR cannot be used (see 
section 12.1) . Instead, the E can load the subtask with a READSKP or READ CIO request. 

Whenever the E decides to start up an SCP, it sets up the Exchange Package (EP) for this SCP, 
I sets RA+1 to XJP and exchanges to CPUMTR. CPUMTR will use the SCP EP and exchange in the 
I SCP after validating the EP set MA=SCP. Now the SCP will run with its own RA and FL in the hard- 

ware CPU registers. (RA and FL must be within the CPs RA and FL or CPUMTR will abort the CP.) 

The SGP is an absolute overlay which must be loaded by the E prior to starting the SCP up. 
When the SCP is done, it may set RA+1 and/or exchange back to CPUMTR. CPUMTR will 
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exchange in the E, which then may process the request or exchange to CPUMTR with this 
request in E*s RA+1. E must pluck the request from the RA+1 relative to the SCP. 

The SCP will exchange to the E under any of the following conditions. 

1) SCP has exceeded its CPU time slice. 

2) SCP enters a request into its RA+1 and/or executes XJ. 

3) CPU detects an error (arith, out of bounds, etc. ) and sets the error flag. 

In summary, the SCP concept allows: 

1) An Executive <E) program to be protected from subprograms 

2) The E has complete control of subprogram EP 

3) Subprograms are essentially relocatable overlays 

4) The system will let E process SCP RA+1 requests 

5) Any number of sub control points may be used 

6) E has time limit control 

7) E is restarted if SCP issues a XJ or RA+ 1 request 

8) The SCP status is shown on the console 

The format of the XJP and SCP EP is shown below. 

XJP RA+l request 

, 18 6 18 18 

(RA+1>= "~ 



I XJP 





time 


addr 



XJP = in display code 

time'= CPU time limit for SCP in milliseconds, i.e., interrupt this 

SCP and exchange to E after the SCP has used time milliseconds 

addr = address relative to this CP of the SCP EP 
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Response 



(X2)= 
(X6)= 
(X7)= 



milliseconds of CPU time before this ca 


11 to the SCP 


2000B+EF* RA of SCP 


milliseconds of CPU time used by SCP 



*EF = error flag caused by SCP, the use of 2000B+EF allows the E to do 
an UXj to get the EF value into a B register and have the RA in an X 
register. 



NOTE: Total CPU time used by this CP at this point is 
X2+X7. 





5S 


53 47 


35 




17 





n 


mm 

m 


P 


AO 


BO 


n+1 


RA mu* 


Al 


Bl 


n+2" 


FL CM* 


A2 


B2 


n+3 


suvr/A 


S23EM Y//////. 


A3 


B3 


n+4 


K^rs* 


A4 


B4 


n+5 


FL RCS* 


A5 


B5 


n+6 


MA** 


A6 


B6 




m^////^//////////////y 


A7 


B7 




xo 




XI 




X2 




X3 




X4 




X5 




' X6 


n+15 


X7 



* These values must be within the bounds of the CP at which the E is executing. 
* *This field is controlled by CPUMTR. In this way the RA+l requests of the SCP will be 
sent 'to the E. 



Figure 3-23. Sub-Control Point Exchange Package (SCP EP) 
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Sub-control points , «s the name implies, are divisions uf a Central Memory oontroi feint. 
A programmer can set up a control point to contain 2 or more programs; one of these will 
be designated as the "executive" which will monitor the other program(s) which are known 
as sub -control points. 

The executive controls its sub -control points in much the same manner that the system monitor 
controls the control points. When a control point makes a system request or exceeds its time 
limit or makes an error, control is given back to the system monitor. Similarly, when a sub- 
control point makes a system request or exceeds its time limit or makes a CPtT error, control 
is given back to the executive. The executive sets up each sub -control point so that, within 
the field length of the control point, each sub -control point has its own "RA" and "FL" and 
cannot go outside its boundaries. The executive is thus protected from access by the sub- 
control points, whereas the executive's RA and FL define the full control point so the executive 
can watch over and control all sub-control points within the field length. 

3 . S . 1 Implementation 

The sub-control point concept depends on the executive program's handling of the sub-control 
points. This involves starting, stopping, error processing and other functions similar to those 
of the system monitor. 

Just as the system monitor keeps track of each control point through its exchange package, the 
executive can control the sub-control points through their exchange packages. 

It is the responsibility of the executive to set up an exchange package for each sub-control 
point; each exchange package must have the appropriate RA, FL, P, etc. , for the sub-control 
point. These exchange packages must be set up somewhere within the executive's field length, 
but probably not within the field length of the sub-control point. To start execution of a sub- 
control point, the executive uses an XJP request indicating the address of the exchange package 
area of the sub-control point to be activated. When CPUMTR picks up the request, it terminates 
the executive and activates the sub-control point described in the exchange package area 
indicated on the XJP request. CPUMTR also sets a flag in the Control Point Area showing that 
at this control point a sub -control point is now active. Once activated a sub -control point 
runs until: 

1 . it makes a CPU error 

2 . it exceeds its time limit 

3. it makes an RA + 1 request 
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Under any of these three conditions, control is given back to the executive. 

The executive can thus monitor error processing for the sub-control points. Errors can be 
noted and examined without termination of the control point. Upon returning control to the 
executive, certain information is set up in the X registers: 

(X2) = msec before this sub -control point began 

(X6) = EF (12 bits) I RA of this sub-control point 

(X7) = msec used by this sub-control point 

One of the parameters on the XJP request is the time limit for the sub -control point. When this 
time limit is passed, control goes back to the executive. 

When a sub-control point makes an RA+1 request, control is returned to the executive; the 
executive can then decide whether to: 

1 . ignore the request 

2. handle the request itself 

3. pass the request on to CPUMTR using RA+1 of the control point (Executive) 

Sub-control points can be set up by any CP programmer using any programming language; some 
features are only usable by COMPASS programs. The structure of the executive is flexible 
within the limits we have discussed so far. Two programs using sub-control points in 
different ways have proved quite useful and are described here to give you some ideas on the 
design and use of sub -control points. 

3.5.2 Examples 

3:5.2.1 TRANEX Overview 

TRANEX is designed to let many different users use one system; each user needs transaction 
processing. Users can set up their own programs for transaction processing and all transactions 
can be handled through the TRANEX executive. 

TRANEX uses sub-control points so that the transaction executive can maintain complete control 
over each task to be performed. Within TRANEX's field length we need a protected area for the 
executive and the remaining field length can be used by up to 31 sub-control points. The tasks 
to be performed require different programs that do not need to be in core simultaneously; rather 
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than using traditional overlays which have no protected area for the executive, each task or 
transaction program can be set up as a sub-control point which can be activated as necessary 
by the executive. 

User transaction programs can be written in any programming language. In order to make the 
"ro^rams mors useful the first 100 word c of e^^h r " ir/ " v '~ f r =i m c h /> uid b ^n^^s*'*^ f^\^ /^i^rvtmnnii-^ _ 
tion between sub-control points; this can be done by using labeled common which is always at 
the beginning of the field length, e.g. , 

(FTN) COMMON /CCOMMON/ A(100) 
(COMPAS) USE /CCOMMON/ 

BSS 100 

(COBOL) COMMON STORAGE SECTION. 

77 A OCCURS 100 TIMES. 

NOTE: 

RA+0 through RA+100 is normally not easily available to 
higher level languages , therefore the technique of labeled 
common allows, an easy method of access to RA+101 
through RA+201. 

The user programs should be compiled and then LINK can be used to create a (0.0) overlay from 
each transaction program. 

Each transaction to be processed must give enough information to indicate the proper transaction 
program to be brought in for processing. This information could include: 

1. user's name (code) 

2 . type of transaction 

3 . data to be used in the transaction 

The executive will then bring in the appropriate transaction program into TRANEX's field length 
and set up the program as a sub-control point. Since the user program is an absolute (CO) 
overlay the loader cannot be used to load it*, so the executive will have to use a CIO function 
to bring in the program. The executive will also have to set up an exchange package for the 
sub -control point and put any necessary information into the 100 word communication area in 
the sub -control point's field length. If the transaction requires another program to complete 

*LDR will always give control directly to the (0.0) overlay after loading; this will not allow the 
Executive to start the sub-control point. 
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the task, a request must be make to the executive to bring in the other program. The executive 
always checks to see of the program is available in core already and brings in a copy if 
necessary; then the executive copies the appropriate data from the communications block of the 
calling sub-control point to the communications block of the called sub-control point. 



3.5.2.2 TRANEX executive 

The TRANEX executive's job is to set up the field length in the most efficient way. The field 
length must contain: 

• the executive's code 

• tables 

• sub -control points 

• exchange package areas for each sub-control point 

The field length could be set up in this manner: 
RA 



^scpr 100 



^CPl 



RA, 



FL SCP1 
SCP2- 100 
RA SCP2 



RA, 



FL SCP2 

•SOPS' 100 
RASCP3 



FL, 



'SCP3 

FL 



Executive 



tables 



-free FL to 
aid in stor- 
age moves 
by the 
executive 
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-100 through RA can be used for the exchange package area for the sub-control 

SGP SCp 

point. The executive can fill in this area as it reads in the program; it gets P from the 50 table 
of the (0,0) overlay binary, it can set up values for the registers for COMPASS programs, it sets 
up RA and Fl depending on where the program was read into memory and how many words were 
read in. 

The executive always checks through its tables to see if the program is already at a sub -control 
point; if it is already at a sub-control point, the executive checks to see if it is a re-usable 
program; if the program is not in memory or not re -usable, the executive will read in another 
copy of it. The executive looks for the next available place in memory to put the program and 
brings it in using READR (READSKP) and updates its tables . The executive must set up the 
exchange package and can then start execution of the sub -control point by making an XJP request 
with the address of the exchange package area. When CPUMTR picks up the request it 
exchanges in the sub-control point and sets the flag in the Control Point Area to indicate 
that there Is a sub-control point active at the control point. 

3.5.2.3 TRANEX S ub -Control Points 

TRANEX sub-control points are all (0,0) absolute overlays. These programs are loaded by the 
executive using a CIO' function. The executive also sets up an exchange package for each 
sub -control point so that each sub -control point can use only memory within its own RA 
through RA+FL-1 . 

TRANEX has set up one sub-control point (ITASK) which decides which other program needs to be 
brought in to handle a transaction. ITASK can look at the transaction code from the user and 
find the name of the program to do the task. Since ITASK is a sub-control point itself and 
cannot go outside its own field length, ITASK must ask the executive to activate the 
appropriate transaction program at a sub-control point. 

When a sub-control point needs assistance from the executive, it puts a request in its own 
RA+1; this causes an exchange back to the executive. The executive looks at the request 
and can: 

1 . ignore the request 

2. process the request itself 

3 . pass the request on to CPUMTR 

After the request has been handled, the executive can give control back to the sub-control 
point if it is appropriate. 
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An example of a request would be a sub-control point requiring the loading of another sub- 
control point to complete a task. When the first sub -control point puts the request in its 
RA+1, the executive is exchanged in; the executive brings in a copy of the program if necessary 
and copies the communications block from the calling program to the called program. The 
RA+1 of the sub-control point is within the FL of the executive who can read the request. 

Sub-control points can be designed in different ways. TRANEX uses the executive to bring in 
(0,0) overlays as sub -control points. TUBE uses the loader to bring in both the executive and 
the sub -control point. 

3.5.2.4 TUBE Overview 

TUBE is designed so that the sub-control point can be any user relocatable program that has an 
RU =XTUBE (CALL TUBE in FTN) instruction in it. The external reference to TUBE will cause 
the loader to load In TUBE after the user's relocatable program. Within TUBE's code there is 
an XJP request; the XJP request will exchange in the user program and set the sub-control point 
bit in the Control Point Area. TUBE will then be the executive and the user program will be the 
sub-control point; all error processing and system requests will have to go through TUBE. Thus 
TUBE is set up to monitor and help debug a user program. 

TUBE was designed to simulate the debugging features of DIS, a program available on the 

operator's console. DIS allows the user to interact with his program using instructions 

such as: 

BKP.a 

ENXj 

ENP 

GO (start the SCP) 

etc; 

3.5.2.5 TUBE Implementation 

TUBE is brought in by the loader when a user program includes an RJ =XTUBE. TUBE will be 
loaded after the last word of the user program. 

The first two words of TUBE's field length are slack words; when TUBE is entered it moves the 
user program down 2 words into these slack words. This means that RA and RA+1 are no longer 
available to the user program and TUBE will have to set up and process all RA+1 requests for 
the user program which is now set up as a sub-control point. 
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user 
program 



TUBE < 



RJ =XTUBE 



2 words slack 



TUBE 



RA 



RA+ 100 



user 
program / 

is 58t Up 

as a sub- 
control 
point 



TUBE is set 
up as the 
executive 



RJ =XTUBE 



TUBE 



XJP 



"X RA 

J now 

J RA+ 1 
controlled 
by TUBE 



FL 



before move after move 

TUBE then sets up an exchange package area within its field length for the sub-control point. 
In this exchange package RA will be set to 2 because TUBE moved the program down 2 words; 
P can be set to the address stored at address TUBE from the RJ (+2) . 

TUBE then can issue an RA+1 request with XJP and the address of the exchange package area it 
set up for the sub-control point. Now TUBE is designated the executive and the user's program 
is the sub -control point. The sub -control point bit will be set in the Control Point Area and all 
error processing and system interface will go through TUBE, 

In order to give control back to the user's program as a regular control point program rather 
than as a sub-control point, TUBE will have to move the program back up and fix up the exchange 
package area so that FL is the original FL, Then TUBE issues an XJR request specifying the 
address of the exchange package area for the user's program. When the XJR request is picked 
up the exchange packages will be switched (i.e. , from the EPA in the FL to the EPA in CPA) 
which will activate the user's program, but the sub -control point bit will not be flipped on. 

3.5.2.6 TUBE' s Structure 

TUBE is set up, as previously mentioned, with 2 words of slack. These 2 words are used in 
moving the user program down away from RA and RA+1 so that TUBE can have control of these 
locations . 
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TUBE also has a buffer area which it uses as the exchange package area for the sub-control 
point. TUBE must set up an exchange package for the user program setting RA=2 etc. , to reflect 
the move. 

Besides these buffer areas TUBE also includes code that simulates DIS features. TUBE has 
routines for interpretting TTY input as DIS interprets console input. For example, from the 
console the operator can enter values for the A and X and B registers using the instructions 
ENX , ENA., ENB . With TUBE, the user can enter values from the TTY using ENX i or ENA, or 
ENB ; TUBE reads the value from the TTY, writes it into the exchange package area for the 
sub-control point and then issues an XJP request which exchanges in the sub-control point with 
the new values for the registers (when ready) to start the program in "DIS" mode). 

When the user's program has been initialized with an XJP it will run as a sub-control point 
until: 

1 . it exceeds its time limit 

2. makes a CPU error 

3. makes an RA+1 request 

Upon any of these conditions, control is given back to TUBE, the executive. TUBE also 
includes code to handle these conditions. 

When a sub-control point makes a request at its RA+1 , TUBE is exchanged back in and it can 
either: 

1 . handle the request itself 

2. pass the request on in its own RA 

3. ignore the request 

Thus TUBE monitors all requests and can catch errors if they occur in this area. 

TUBE also monitors CPU errors. It prints out a message on the TTY and will accept input from 
the user to determine what step should be taken next. 

Since TUBE is the executive it can access the entire field length and can modify code within 
the user program. In this way the BKP feature is easily implemented by saving the BKP instruc- 
tion word' and setting it to zero. When the BKP occurs the word can be restored. Hence, TUBE 
can BKP on an instruction address, next or last address or on RA+1 requests. 

TUBE uses the capabilities of the executive to monitor and modify a user progra. This shows how 
the sub-control point concept is a convenient tool for testing and debugging programs. 
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3 ., S . 3 Sequence of X*? for Sub-Control Points Showing What SGX in CMR is used for PTX« 



CPi FL 



RA 
RA+1 



EPA: 



scp 



RA 



FL 



scp 

scp 

FL 



XJP 



EPA, 



SCO 



Executive 



R =RA 
•FL = 
MA= 



N/S 



scp 

cp 



(T) 




SCP's sex 

EPA = 2 OB words 



SCX 




CPi Executive executing in PM 



Executive makes XT 



RA 
RA+1 



EPA, 



scp 



RA, 



scp 



FL 



scp 



FL 



Executive 



P = 

RA =RA scp 
FL =FL„ 
MA= 



v=nA 



cp 



© 



cp i 


CPA 


CPj EP 
MA=CPA. 







SCX 




ATX 
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CPUMTR executing in MM 



* indicates 
change 



3-30.9 | 



PTX 



RA 
RA*1 



CPj 



FL 



CPUMTR saves P, AO, B2, and B7 in SCX 

and sets MA scp =SCX and 

sets S=l, X6=RA scp 



EPA 



scp 



RA: 



scp 



FL, 



scp 

FL 



Executive 



RA =RA scp 
FL =FL scp 
MA=SCX 



© 





CPj 


CPA 


C? i CPA 


X6=RA scp 






S = l 







SCX 



P=MTR AO=CPU}] 




B2=EPA SC p 


MA=0 


B7=CPAi 


all else N/A 



CPUMTR still in MM (setting upSCX and CPA) 



CPUMTR XJ B2=EPA scp 



ATX 

RA 

RA+1 



CPi 



CPA 



EPA 



scp 



RA, 



scp 



FL, 



scp 



CPUMTR EP 
MA=0 



© 



CPj EP 



no change 



S=l 



SCX 



SAME AS ABOVE 



(note: in 
CPU now 
MA=SCX) 



Now SCP executing in PM 
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CPi FL 



RA 
RA+1 



EPA 



scp 



RA, 
RA+1 



scp 
scp 



FL. 



scp 



FL 



Executive 



CPUMTR EP 



request 



© 



CPA< 



CPiEP 



S=l 



SCX 



SCP executing 
in PM 



CPUMTR EP 
same as above 



SCP issues XJ (MA)=SCX 



PTX 
RA 
RA+1 



CPi 



EPA r 



scp 



RA, 



scp 



FL 



scp 



Executive 



SCP's EP 



MA=SCX 



request 



© 



CPA t 








X2 


* 






X6 


* 


X7 


* 




s=o 




* CPUMTR 




copies 
SCP'sEP 
to EPA- cp 
and sets 
X2, X6, 
X7 in 
CPA t 




SCP's EP 




MA=SCX 










i 
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CPUMTRXJ B2=CPiCPA 


ATX 


CPiFL 




CPAj 




RA 
RA+1 




© 

CPj Executive 

executing 

in PM 


CPUMTR's EP 











Executive 








S=0 












EPA scp 


SCP's EP 
























MA=SCX 












sex 












SCP's EP 


(Note: in 


RAscp 








CPU now 




request 


MA=SCX 




MA=GPjCP/ 












FL 








r Scp 

FL 
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3 * 5 , 4 Reasons for Using SCX 

1. P=MTR, AO=CPU number and B7=CPA B2=EPA gcp are the only parts of the SCP EP that 
are important to insure that it can not be changed . 

2. IF SCP EP is only saved in Es FL then some PP routine working for the E while SCP 
executes could clobber SCP EP in Es FL but would never disturb SCX. Hence, we 
protect the system from a possible XJ which moves garbage into the CPU registers. 
(Hence protecting CPUMTR exchange package.) 

3. CPUMTR must copy SCX back into SCP EP in ES FL so that the E can read it and/or 
write to it and restart the SCP without completely rebuilding it. 

4. Possible sequence that can cause problems. 




a. E calls CIO without Auto-recall. 

b. E calls XJP to start SCP. 

c. E has inadvertently specified a buffer which includes the SCP EP and it is 
clobbered by CIO. 

d. SCP makes an XJ and if MA=SCP EP in Es FL, CPU hardware registers get 
garbage and system is destined to crash, since CPUMTR exchange package 
living in SCP EPA. However, since MA=SCXin CMR, this problem is 
circumvented and no system crash is forecast. 

The point of setting S=l (sub-control point activity flag) allows. 

a. MTR to get SCPs RA from X6 in CPA. 

b. CPUMTR to know that an SCP versus a CP is making a request. 
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3. 6 MTR - PP MONITOR 

MTR is loaded into PPO at dead start time and remains there for the duration of system 

MTR performs the following functions: 

1. Process certain PPU requests 

2. Allocation of central memory 

3. Check the CPU for arithmetic errors CD=0 

4. Maintain the real-time clock 

5. Check (RA+1) of active central programs for system requests 

6. Check the status of active control points, so that he can call 1AJ if zero 
status or rollout status on a CP 

7. Checks OR of each pool PP. 

8. Start IS J periodically. 

3.6.1 Starting MTR at Dead Start Time 
MTR is loaded in PPO. The first location of the code is: 
TO CON PRS-1. 

This forces the constant PRS-1 to fall into TO. At the end of the load (P) will be set to 
<T0)+1 which will be (P)=PRS, the MTR preset routine. PRS will preset all tables and 
constants. It will create the following tables at the end of the channel table (TCHS) which 
is generated in the code. 

TPPR Table to hang illegal requests 
PPR Table of request processor address 

PRS will overlay itself with the following tables 

TMSD Table of mass storage devices 

TMSP Table of mass storage space available 

TSYS Table of system devices 

TFUN Table of release functions 

TUFL Table of unas signed field length 

and a message buffer in the top end of core. Then it will effect a jump to INT which will 
initialize all the tables. When INT is complete, it will jump to the main loop MTR. 
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MTR 




Write 

Channel 

Table 



CCP 

Check 

Central 

Program 



* 1 This simulated loop is actually a DUP statement in MTR code. 

*2 When MTR releases a channel, he sets a flag. At this time, the reservation byte in 
the channel table in CMR is actually cleared. 



Figure 3-24. Main Loop for PP MTR 
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Compute 
Elapsed 
Time 




Scan 
Processor 
Table 



RJM to 
This Scan 
Processor 




*5 



Advance 
Scan Index 

SI 




Reset SI = 

TTSP = 

Start of Scan 




■ 1 i tiese operations are performed for all scanners and at any one time, this operation is 
for the current scanner. 

= 2 Current time — start time 

: 3 Elapsed time — delay time 

: 4 See * 1 scan processor Table 3-6 

; 5 Scan index is saved in cell SI. 



Figure 3-25. Process Time Dependent Scanners 
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TABLE 3-6. TIMED SCAN PROCESSOR 



Symbol 


Value 


Description 


TTSP 
. JAC 

. JAS 

.CRC 

.PPL 
TTSPL 




FWA of ART 


*2 

*3 


Advance running times (ART) 

Start time 

Delay time in milliseconds 

Check job activity (CPU time slice) 

CPU switching (CPU slot time ) 

CPU recall (periodic recall) 

PP recall (process PP recall register) 
and AUTO-RECALL for CPU 

End of table 





innnn 


n 


FWA of JAC 











FWA of JSW 











FWA of CRC 











FWA of PPL 
















*3 



Each time through the MTRs major loop, only one time dependent scanner will execute. 
In addition, the fortunate scanner will scan only a specified number of CPs. In Figurt 
3-25 (*4), MTR will specify the CP to start scanning, and how many CPs to scan. On 
return from the scanner, MTR will save the number of the last CP scanned in order to 
restart next time through the loop. 

ART copies the delay time from CMR word MSCL into the 4 other processors table. 
These delay times can be changed by the operator and ART will change them for the 
processors. 

PPL will start up any PP whose name occurs in the PP recall register word RLPW 
in control point area. 
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3. 6. 2 Real-Time Clock 

The reat-time clock starts with power on and runs continuously. It may be read by any 
peripheral processor with an input to A (TO) instruction from Channel 14B. This channel 
is separate from the data channels. 

The clock period i3 4096D (10* Q00B) major cycles* . It is a 12-bit register that is advanced 
each microsecond from 0000B through 7777B. When it reaches 7777B, it starts over at 
0000B. It must, therefore, be read at least every 4. 096D milliseconds for accurate timing. 

The AVC (Advance Clock subroutine) updates the clock. AVC must be entered at least once 
every 4 milliseconds. In case AVC is called too often, AVC will check the constant MLSC, 
and, if the elapsed time from last call is less than MLSC, it exits without updating the 
clock. AVC will update its own internal clock whenever called, unless called before MLSC 
has elapsed. If RTC has advanced at least 1 millisecond, AVC will update the real-time 
clock in CMR, RTL word 106, Figure 2-2. 



1 Major Cycle = 1 Microsecond = 1000 Nanoseconds. 
1 Minor Cycle = 0. 1 Major Cycle = 100 Nanoseconds. 
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Advance 
Second Count 
and Store in 
RTC1 



L 



AVC 



\ 



CPR 



A*: 



(A) = ARTF 



CPR 



(A) = ARTF 



Advance Second Clock updating 
running times for central programs. 



*1 Advance CPU time. Accumulated 
CP time for active CP at CPUO. 

*2 MSCL can be dynamically set from 
the console. ART reads it every 
second. 

*3 MTR making a CPUMTR request. 

*4 Time interval in MTR cycles to call 1SJ 



Read Scan 
Times from 
MSCL 



*2 
(MSCL)= 



1SJ 


CPU 
Call 


PP/Auto 
Recall 


Job 
Act 


Job 

Switch 



CPU Recall Delay .CRC+2 

PP Recall Delay . PPL+2 

Job Activity Delay . JAC+2 

Job Switch Delay . JSW+2 



Read 

Scheduler 
Control 
JSCL 




(JSCL) 



FTN 



1SJ Cycle *4 
Interval 



1SJ requested flag 



\* 3 / UMS \ 



RSJM 





Return 



~) 



Figure 3-26. ART Advance Running Times 
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No 




* 1 ADC will advance to next CP on exit: 
ADC considers system control as end 
of scan and will set (A) = 0. 

"2 Recall CPU, 



(A) = if all CPs checked 
j- if active CP found 
(CP) = CP number 
(CS-CS+4) = CP status 



Figure 3-27. (CRC) - Check CPU Recall Status (Periodic Recall) 
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(jsw) 



Note *1 
Figure 3-27 



Return 




YftS 



Yes 



Read Job 
Control Word 

(jcrw) 



Read CPUO 

Status From 

(ACPL) 





No 



CPR 



No 



CPR 



(A)=ACSF+ 
10000B Ad- 
vance CPU 
Switch 



Return 



Read CPU1 

Status from 

(ACPL+1) 



(A)=ACSF 
Advance CPU. 
Switch 



No 




'Old' 
Job Idle 



Yes 



Return 



No 




Yes 



1 CPUO active job CPU priority > this CP CPU priority. 

2 CPU1 active job CPU priority > this CP CPU priority. 



Figure 3-28. JSW - Process CPU Job Switching (CPU Slot Time) 



3-38 



97404700B 



Note *1 
Figure 3-27 



J AC j 

t 




Read Job 

Control Word 

From JCIW 





Read CPU 

Time From 

CPT W 




Set Rollout 
Flag in 
JCIW 



Return 



1 Byte of STSW 

2 Call up job advance PP routine 



Figure 3-29. JAC - Check Job Activity 
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Return 



J 



Read Time 
Slice Control 
Word (TSCW) 



No 



Set Time 
Slice Inac- 
tive TSCW 



Set Priority for jTime Slice Expired 



Read Jobname 

From JNMW 



Origin is 

I ° th ? r t 9 han <"dentified V 
0, l, l, \nrigin/ 



3, 4 



I 




No 



RJC 



Read Roll- 
out Control 



Read job 

Control 

JCIW 




Return 



Set Queue 

Priority 

Lower Bound 



X 



Store Job 

Control Word 

JCIW 



3= 



FTN 



RSJM 



Return 



: 1 is MNPS (minimum priority for scheduling) < priority > MXPS (Maximum priority for 
rollout). 



Figure 3-30. Check CPU Time Slice 
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PPU 



Note * 1 L 



/ ADC \ Fi S ure 3 " 27 




Read Job 

Control 

JCIW 




1 


No 




Yes 




Get CP 

Status 






./IS ^J 


= 1 




CP reques-N. 
ting auto re^ 
\. call/ 


Read 

(RA+l) 
of CP 







Yes 




| No 



Read PP Re- 
call Register 
RLPW 




Return 



J 



request PP 



Clear PP 

Recall 

Register 




Return V- 



CPR 



(A)=IARF s 
initiate > 
auto-recall / 



Return 



3 



1 Is CP status bit for auto-recall set. 



Figure 3-31. PPL- Process PP Recalls 
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MTR has many other non-time -dependent routines. A few of them are flowcharted on the 
following pages. 



UMS updates TMSP table based on current 
system status 1 any device with less than 




12. 5% of its tracks available is put on 
restricted status, i. e. , it will not be used 
as scratch until all devices are restricted. 



Get 

Equipment 




Get next 

equipment 



Set tracks 
Available in 

TMSP 




Set 
Unrestricted 

Status 



Set 
Restricted 

Status 



Store 
Status in 

TMSP 



* 1 MS is mass storage. 



Figure 3-32. UMS - Update Mass Storage Tables 
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PP function requests are made to MTR by placing the function code in byte of the PPs OR. 
When the request is complete, MTR clears byte of the OR. 

[pSDj * 1 



Read OSDs 
IR and Set 
CP Assign- 
ment 



Indicate 
Storage Move 
in Progress 




*2 

■♦/fnrJ 






zz 



CCP 



Set 

Appropriate 

Processor 



Exit to 
Proper Processor. 



Return from processor 
FNZ - if successful 
FNR - if unsuccessful 



Check 

Central 
PGM 



[mtrJ 



* 1 When DSD wants to do an action for a CP (such as n. XXX), he temporarily attaches him- 
self to that CP by placing the CP number in his IR, then he makes the request, 

*2 If this CP is moving the status must be set. 

*3 I.E., if request illegal then effectively hang PP since OR is never cleared this will not 
display PP hung at system PP. 



Figure 3-33, DSD PP Function Request 
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If any of the functions requested desire an illegal operation (for example, DCHM drop chan- 
I nel wishes to drop a channel which does not exist) then it will jump to this routine. 




Display- 
Message 

"HUNG PP" 



[fnr] 



*1 



* 1 Don't clear OR and thereby hang this PP. 



Figure 3-34. HNG - Hang PPU and Display Message 
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[FTNJ 



Set 
Request -» CM 



Set CT L. pt 

Number 
-* FTNA+I 



Store IR 
i.e., 

MTR IR 



ENTRY: (A) = Function Number 

(CM+1, .... CM+4) = Parameters 
(CP) = CTR.pt. Area Address { 

EXIT: (cm, .... CM-4) = Response 

CM is FTN request word. 
CN is CPR request word. 



(CM, ...,CM+4) 
-> MTR OR 



CPR > 
Request PP 
Function / 



AVC 



Advance 
Clock 



Read OR 




Yes •— 



Return ) 



Figure 3-35. FTN — Process Monitor Function 
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(ccp) 

Check storage move status 




The contents of the RA+l for the CP at this 
CPU are checked and the CPUMTR is 
requested to process the request. The 
program address (P) is checked and if = 0, 
CPUMTR is requested. 



1 



Read Active 
CPUAddress 
(ACPL) 



Get CP 
Address and 
Read CP 
Status (STSW) 



RA-- 




*3 



System 
CP request 



{ No 






/is it N^ 
s. a sub j? 
\. CE/ Yes 


Get RA+l 

from 
Sub CP 


J No 






Get RA+l 
From CP 








' 








' 




* 1 Check active CP in CPUO then CPU1 get CP number in CPUO. 
*2 A user CP is running, i. e. , this is not CPUMTR. 

* 3 If CEJ/MEJ available, then go to CCP1, if not then go to XJ1 on next page. 
*4 If (RA) = 0, then this is CPUMTR and we can ignore it. 



Figure 3-36. CCP - Check Central Program 
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(CCP) 
3^ 
Request CPUMTR' 
to process 
(RA+1) request 



Clear Request 

Word -» 

CN, CN+1. 

CN+2 



Request 
RA+1 Check 

-» CPR 



CPR 





Request 
Arithmetic 
Error Check 



/ CPR 



CN+4=CAEF 

Request 

Code 



Check next CPU 



No CEJ/MEJ Option 

& 



!■•- -Read . 
'. Program 
Mode Status 



*3 



1=1 If hardware detected error then 
(P) = 0. 

*2 No if (PX) = 0, yes if (PX)?0 
PX is defined in CPUMTR. 

* 3 Use PR defined in CPUMTR. 




^ 



Yes 



Request is null 



Figure 3-36. CCP - Check Central Program (Continued) 
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ENTRY: 




Store 
Request 
in CN+4 



Enter request 

+ 



Store P = 

PMN (AO) (BO) / 

in EP 



Store (XO) = 
(CN, CN+4) 





MXN 



Set up MXN 
inst to 
correct CPU 



(A) = PPO 
(MTR) 

EPA 



MXN 
Exchange to 

CPUMTR 



Read P. Ao7 
BO from PP 
.EEA 




(A) bits 0-11 = request 

12-17 = CPU number 
(CN, . . . , CN+2) = parameters 



Check (MA) 
in.PP EPA 




* 1 This request will be processed by CPUMTR at PMN. 

| * 2 PMN expects the request in XO. 

*3 If CEJ/MEJ option available, use code on this page. 

If CEJ/MEJ option not available, use code of Figure 3-38. 

*4 Was this an RA+1 check. If no and exchange occurred then CPUMTR is now running 
and he will automatically process this request. If not, then reissue the exchange. 

*5 When CPUMTR has completed, he will exchange in the user CP interrupted whose 
i EP is in PPO EPA, as long as CPUMTR is executing CPn EP is inPPOEPA and any 

V user (MA) = CPA of user CP. When CPUMTR exchanges to interrupted CP, then 

CPUMTR EP will be in PPO EPA and CPUMTR (MA) = 0. 

*6 There is a delay loop of 6 MICRO seconds. 
LON 5 
SBN 1 
NJN *-l 

Figure 3-37. CPR-CPUMTR Request Processor 
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!mxn! 



Set EXN insts. 
to reflect the 
correct 
CPU 

J 



A = PPO 
XCHG. pkg. 
address 




Read MTR/ 
CPUMTR 
Interlock 
Word 



MTRL = 76B in CMR 



Set (A) = ex- 
change address 
from MTRL 



EXN 
XCHG to 
new job 



r 



T 



Return J 






f fka r"P +t\ He 



MTRL and jumps to a one word idle loop at CPSL = 77B in CMR, which is a zero word, i.e. , 
a PS. MTR is doing an RPN and waiting, for (P) = CPSL. 

Figure 3-38. XCHG - The CPU With CEJ/MEJ Not available 
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1 1 Request job advancement. 



Figure 3-39. ACP - Advance Control Point 
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3. ? CPUMTR - CENTRAL PROCESSOR MONITOR 

CPUMTR is loaded in CMR and is entered at various places depending on what exchanged the 
CPUMTR. 

The entry points are: 

1. MTR — CPU program request 

2. PMN - PP MTR request 

3. PPR - Pool PP request 

4. PRG - Program mode CPUMTR (system CP) 

5. IDL and IDL1 — Idle packages 



f MTRX V 




Copy Reply 
into PPs OR 






XJ B2 

Exchange to a 
control point 



MTRP entry: (X7) = 



reply word to be set 
into calling PPs 
output register 



MTRX entry: (B2) = 



address of exchange 
package for CP to be 
exchanged into CPU 



exit: (P) = MTR 



Figure 3-40. CPUMTR Return Points 
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Get RA from 
EP and Read 
RA 



Read 
RA + 1 



Entrv. (AO) = CPU number (0 or 1) 

(Bl) = 1 

(B2) = address of caller's EP 

(B7) = control point area address 

NOTE: If CPn exchanged itself, then (B2) = 
(B7) and EP will be in CPA. If CPn 
was exchanged by MTR or some other 
pool PP, then (B2) = the address of 
the PP EPA which performed the 
exchange and (B7) = CPA. 




Check for monitor request. Note that we are 
checking the address for RA against 0, i. e. , 
is this exchange a CPUMTR EP or a CP EP. 



Process the RA+1 request. 



Read P (B2) 

= P in EP 
Set (X7) = 2 




Exchange CP back in. 
pause. 



CP wanted a short 



SEF is not flowcharted. 



Set error flag CPU detected on ARITH error. 
Uses (B7) = CPA, (X7) = error code. SEF 
will abort the CP program on ARITH error. 



Figure 3-41. MTR - Exchange Entry From A CPU Program 
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'MNR' 




Read PX 




<XO) = 



[ecpJ 



PX is FWA of CPUMTR code and is the PROGRAM MODE 
EXIT REQUEST. It is set when program mode portion of 
CPUMTR has determined that this CP job is complete. 



Yes p 



Read PR 
Set (PX) = 




Yes 



This is to determine if a CP or if the 
system CP (CPUMTR program mode) 
was interrupted. 

PR is a pointer to a stack of requests 
for program mode execution (i. e. , 
system CP queue). 



Let system CP continue running. 



ECP end central program. 

Uses (B7) = control point area address 
(XO) = status bits 
By setting (XO) = we set CP status = or not active. 



ECP is not flowcharted. 



Figure 3-42. CHECK - For System CP Request 
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Read Subcon- 
trol Point status 
(SCPS) from bit 
56 of STSW in 
CPA 



| Check 
Requests 




Entry: (B3) = RA 
(B7) = CPA 
(X5) = (RA+1) 

(A2) = address of RA in EP 
(A5) = RA+1 

None of these CP procedures are flowcharted. 
If they end normally, they exit via MTRX. 



BCE - begin Control Point Executive 



There are 9 more requests as of August 1, 
1973. They are: 

CPM 

END 

RCL 

TIM 

RSB 

RFL 

XJP 

TLX 

XJR 

SIC 



assign a PP put request in PPS IR. 



Process CPU Call Error 



Figure 3-43. Process — RA+1 Requests 
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Yes 




Read OR and 
get request 



-iri 



Unpacks 
Request 



Proper Processor/ 




: 1 MXPF is maximum number a PPMTR request can be, so test is (XO) - MXPF > 0, then 
go to PMN2. 

2 Those processors which require program mode CPUMTR will exit via EPR. EPR will 
check to see if the system CP was interrupted for this request and if so, will exit to 
MTRX. If a CPn was interrupted, then it will exit to BCP1, which will place this now 
deactivated CPn into "W" status, and then exit to MTRX. 



Figure 3-44. PMN - Exchange Entry From PPMTR 
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(PPRJ 



Entry: 



(A5) = address of calling PPs OR 
(B2) = address of calling PPs EP 



Read OR 




Select 

Appropriate 

Processor 



Exit to 

Proper 

Processor 



Each processor will exit: 

to MTRP with reply word in (X7) 

for PPUs OR if necessary, 

- OR - 

if no reply word necessary, then 
exit to MTRX. 



If the processor requires program mode CPUMTR then 
the macro PPR will generate a queue entry and set up 
the EP, then jump to PRG will see no request and jump 
PRG1. 



: 1 Check to see if request (which is a number) is larger than the maximum. 

■2 Hang PPU by not clearing OR, and display message PP HUNG at System CP. 



Figure 3-45. PPR - Exchange Entry for Pool PPUs 
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CPUMTR starts the Program Mode portion 
at PRG in Program Mode. This is the stand- 
ard exit for program mode CPUMTR. 



Set Request 

Exit 

PX = 1 



XJ 




Exchange to CPUMTR in monitor mode. This 
will force (P) = PRG in EP in the system CP 
CPA, so that the next time CPUMTR starts 
up the system CP, execution in Program 
Mode will begin at PRG. 



Get Request 
Word PR 




No, hence, it is a PP request. 



Figure 3-46. PRG — Exchange Entry for System CP (Program Mode 
CPUMTR) 
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IDL and IDL1 - CPUO and CPU1 Idle Loops 

The exchange packages for IDL and IDL1 are loaded at the end of CPUMTR 



<P) = 


2 


(RA) = 


location of IDL in CPUMTR 


(FL) = 


5 


(MA) = 


location of this EP 


(EM) = 





all othe 


r registers = 



(P) 


= 2 




(RA) 


= location of IDL1 in 


CPUMTR 


(FL) 


= 5 




(MA) 


= location of this EP 




(EM) 


= 




all other registers = 





Program IDL 

0000 IDL CON 

0001 • CON 



0002 



EQ 



(RA) for idle routines 

(RA+1=0) for idle 

routine 

never any requests 

jump to itself 



Program IDL1 

IDL1 CON 
CON 



EQ 



~® 




-MIDL1 



Program IDL and IDL1 will run until a PP or MTR interrupts them and exchanges CPUMTR 
into the CPU. If. CPUMTR finds no other jobs to run he will exchange IDL or IDL1 back 
into the CPU. 
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4. PPR SYSTEM INTERACTION 

PerfpfieraTProcessor Resident (PPR) provides the communication links between the PPs 
and the CPs. It serves as a PP idle program, the loader of PP programs and routines, and 
a convenient source of commonly used subroutines for other programs and routines. PP 
Resident is loaded at dead start time by STL and is never changed. 



Each PP is a separate entity which can function independently of the CPU and operating sys- 
tem. It is desirable for the PPs to function in conjunction with and as a servant to the 
operating system. Therefore, PPR is designed to enable the PP to communicate with and 
work for the system. 

When the system desires to start a PP program, CPUMTR will find an available PP (one 
whose IR = 0) and place the PP routine name (3 characters) and up to two arguments in the 
PPs IR. (i.e. , up to 36 bits of arguments; see SYSTEM macro). 

PPR consists of a set of routines shown in the core layout of Table 4-1. 

Refer to Figure 4-1 for the following discussion of the flow of system to PP communications 
PPR reads its IR and if zero, will wait 128 microseconds through the Idle Loop before re- 
reading. When the IR is not zero, PPR will request PLL using SLT to locate the requested 
routine which is in either the RPL or PLD. If the requested routine is not found, SFP will 
be loaded (refer to paragraph 4-9). If the requested routine is found, it is loaded by PLL 
and execution will then begin. As the routine is executing it can communicate with the sys- 
tem by issuing monitor requests via the FTN part of PPR (refer to Tables 3-1 and 3-2). 
FTN communicates with the system by placing the monitor function request in its OR and 
starting monitor. 

Control is returned to the routine after the function has been processed. 

CP programs can be moved when the PP pauses for relocation via PRL, When the routine 
uses an I/O device it reserves and releases channels via RCH and DCH. When the routine 
issues a message to the dayfile it uses DFM. When the routine loads and/or executes 
overlays it uses EXR. And, finally, when the routine drives an RMS device the SMS routine 
will load the proper driver and via entry points POS, RDS, and WDS can read and write. 
When the routine is completed it simply issues monitor function DPPM via FTN and jumps' 
to PPR. 
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TABLE 4-1. POOL PROCESSOR MEMORY MAP (as of Release 8/24/73) 



First word address 
0000 
0100 
0125 
0307 
0350 
0414 
0436 
0445 
0454 
0533 
0544 
0600 
1073 
1100 

7000 BUF 

7502 
7777 



DIRECT CELLS 



PP RESIDENT (PPR) idle loop of PP 



PERIPHERAL LIBRARY LOADER (PLL) 



SEARCH LIBRARY TABLE (SLT) 



PROCESS PP MONITOR FUNCTION (FTN) 



pAtfSE POR RELOCATION (PRL) 
RESERVE CHANNEL (RCH) 



release Channel (dCh) 



SEND DAYFILE MESSAGE (DFM) 



EXECUTE ROUTINE <EXR) 



SET MASS STORAGE (SMS) 



MASS STORAGE DRIVERS 



LOADER TABLE OF CURRENT PPU ROUTINE 



FWA of current PPU ROUTINE 



MASS STORAGE BUFFER 

2 words of PRU control and 500 words of information. 

502 words total 



MASS STORAGE ERROR PROCESSOR 



LAST WORD OF PPU 



4.0.1 KRONOS/NOS PP Naming Conventions 



NAME 

Yxx 

Oxx 
lxx 

2xx 
3xx 
4xx 
5xx 
6zz 
7zz 



DESCRIPTION 



RA + 1 CP callable routine 

Location free routine 

First level system routine callable by RA X 1 TLX 
request 

Second level overlay 

Third level overlay 

Fourth level overlay 

Fifth level overlay 

MS driver routine 

MS error processor routine 
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NAME 



DESCRIPTION 



8xx Unused 

9xx Syntax type used by DSD, DIS, 1LS, 1TD, and QIS 

Where Y is any alpha character 

sac is any tw© characters including specials 

zz is any legal MS mnemonic 



4. 1 PP RESIDENT 



RESTORE PPR IF DESTROYED 
(e.g., BY 1TD) 



PP2 RESTORES PPR 



o 



PP2 CALLS 1RP 



IR 

OR 

MB+0 



1TD 



RPPM 



1RP 



1a 







CPUMTR Assigns 
1RP to PP4 



ia=IA Address of this 
PP (PP2) Input Register 



CPUMTR 
>PP4 IS. 

OR 



1RP 



la 







CPUMTR informs 
PP2 which PP has 
ISP 



PP2j 
Q, IR 



1TD 



LA 



CB 



IA=IRAddr. of 1RP 
CB=CcmpietIon Byte 



PP4? 

C IR 



1RP 



^ 


PP2p 

Cm 


1RP puts 6 CM 




words of its PPR 




mto calling PPs 


OR 


(PP2) MB and sets 


MB 


its (PP4) Ready byte 




to 7777B 


MB +5 
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1TD 



LA 



CB 



5 Words of PPR 



PP 



Z 



IR 
OR 



1RP 



READY ia 
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i Subsequently, PP2 restores 6 central memory (CM) words (36 PP bytes) of PPR and if 1RP 
has fee ready byte set ?P2 will set its completion byte (CS) / S 

| PP4 (1RP) will copy the next S central memory words (36 ?? bytes) of PPR and set its 
ready byte. 

1RP (PP4) and the requesting PP (PP2) continue until all of PPR has been transferred, then 
IS? (PP4) drops. 

1TD must set the Ready byte in IRPs IR within 1 sec upon regaining control or 1RP wiH drop. 

1TD will set CS to zero when it is ready to receive 3S bytas of PPR. 

IRP will set C3 to 400X where X is the number of CM words transferred by 1RP. When 1RP is 
done it will set CM to 7777 and drop. 

4.2 DAYFTLE MESSAGES (ALL MESSAGES ARE ISSUED 3Y SFP, SPECIAL FUNCTION PROCESSOR) 

The dayfiie messages are: 

"XXX NOT IN PP LLB. " * PP Package XXX was not found in P? LIBRARIES. 

"XXX NOT IN PP LIB. - CALLED BY YYY." * PP Package XXX was not found 
in the PP LIBRARIES and was called by package YYY. 

"SFP/XXX PARAMETER ERROR." = Parameter address outside FL. 

SFP/XXX ILLEGAL ORIGIN CODE." = Function Illegal for users job origin. 

"SFP CALL. ERROR. " * SFP not loadedibv default. 
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PP Resident 




No 



Find PGM in 
RPL or PLD 



Load and 
execute the 
requested 
program 



Inform 
monitor of 
end of 
operation 



Yes 



h?PRj 



PP Communications 
Area 



Control Point 
Number 



Yes 





PGM 









Message 
Buffer 



<z 




PGM 




DPPM 









< 



Assign PP 
to this 
Control Point 



* 



Yes 




Monitor checks 
this PPs 
output 
register 



Clear IR 
and OR and 
indicate this 
PP is free 



Figure 4-1. System Interaction — PPR 
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4.3 ROUTINES USED § 
The following routines are used: 

1DD - PROCESS DAYFILE DUMP. 

A MASS STORAGE DRIVER. 

SFP - SPECIAL FUNCTION PROCESSOR 

Used for SCOPE 3. 4 compatibility and is called if PLL does not find an entrv in the 
PLD. 

The following routines must reside in RPL.' 1DD, SFP, LSL, ODF and all the mass storage 
drivers. 

The four instructions CRM, CWM, IAM, and OAM use cell TO to hold the value of the P 
register while executing. If TO is changed during execution of any of these instructions, the 
next instruction to execute will be at the location specified in (TO). This is used by SFP to 
autoload and force an immediate transfer to the instructions just read in. 

Table 4-2 shows the Direct Location Assignments available for PP programs. 

The direct cells ON, HN, TH, TR, IA, OA, and MA are the only cells that must not be 
changed by a user PP routine. 

4.4 PP RESIDENT INITIALIZATION ■ 

The PP resident initialization routine PRS is initiated at dead start and will be overlayed by 
the first mass storage driver loaded (i. e. , PRS resides at Location 600). PRS prepares 
the PP Resident routine by setting up the proper cells and setting up the exchange package 
address in the routine FTN. The procedure is described in Section 24 on Deadstart. I 

4.5 LOADING PP ROUTINES I 

The CPUMTR, or any PP routine, can place the name of a PP routine in an input register. 
The CPUMTR will determine the availability of PPs and will pick the next available PP for 
a PP program request. If a PP program is told by CPUMTR that no PPs are available, 
he may load the requested routine by inserting the program name into this PPs own input 
register. 

PPR loops on its input register checking for non-zero. When PPR finds it non-zero, he 
transfers to PLL to load the requested routine. 

PLL will search the RPL (via subroutine SLT)for the name of the requested PP routine. If the 
name is not found.it will search the PLD. If the name is still not found, the last word of th? 
PLDwill force the loading of SFP (the Special Function Processor). SFPwill determine if t ;e 
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TABLE 4-2. DIRECT LOCATION ASSIGNMENTS 



Symbol Name 


Location 


Description 


TO 

Tl 
T2 




1 
2 


TEMPORARY STORAGE 




T3 


3 




T4 


4 




T5 


5 




T6 


6 




T7 


7 




CM 


10 


CM WORD BUFFER (5 LOCATIONS) 


LA 


15 PACKAGE LOAD ADDRESS 




SET BY PP RESIDENT BEFORE ENTRY TO PROGRAM. 


IR 


50 


INPUT REGISTER (5 LOCATIONS) 


RA 


55 


REFERENCE ADDRESS/ 100 


FL 


56 


FIELD LENGTH/ 100 




READ ONLY CONSTANTS. 


ON 


70 


CONSTANT IB 


HN 


71 


CONSTANT 100B 


TH 


72 


CONSTANT 1000B 


TR 


73 


CONSTANT 3B 




SET BY PP RESIDENT BEFORE ENTRY TO PROGRAM. 


CP 


74 | CONTROL POINT ADDRESS 




READ ONLY CONSTANTS. 


IA 


75 


INPUT REGISTER ADDRESS 


OA 


76 


OUTPUT REGISTER ADDRESS 


MA 


77 


MESSAGE BUFFER ADDRESS 




PP RESIDENT ENTRY POINTS. 




"PPR" IS ENTERED BY A LONG JUMP. 




ALL OTHER ENTRY POINTS ARE ENTERED BY A 




RETURN JUMP. 




PPR 


103 


PP RESIDENT IDLE LOOP 


PLL 


125 


PP LIBRARY LOADER 


FTN 


364 


PROCESS MONITOR FUNCTION- 


PRL 


424 


PAUSE FOR RELOCATION 


RCH 


437 


RESERVE CHANNEL 


DCH 


446 


RELEASE CHANNEL 


! DFM 


501 


PROCESS DAYFILE MESSAGE 


EXR 


533 


EXECUTE ROUTINE 


SMS 


547 
OTHER CONSTANTS 


SET MASS STORAGE 


PPFW 


1100 


FIRST WORD ADDRESS FOR PP 
PROGRAMS 


ESTS 


551 


CONTAINS FIRST WORD ADDRESS 
OF EST 
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call is for one of its functions. If so, SFP will check the parameters if they exist. If any 

,_".__ w .x.w ^,>-.** ^.w *»* w-k o vu w v* *.*. uj.iv. J. J. i UUKUiC J. VMU\, Sl-UU XO m_/L UllC WA 1I.D 1 U.11V- LiULl^j i^ Will 

issue the appropriate dayfile message, inform CPUMTR, clear the input register, and return 
control to PPR. 

If, at any time the requested PP routine is found, it will be loaded and control will transfer to 
the first instruction at PPFW, 

4. 6 6000-SEREES PP ABSOLUTE CODING FORMAT 

Binary output for a 6000 -Series PP program or overlay is a logical record that may contain 
the following: 

A prefix table 

A 6000-series PP program control table. 

The PPU text in five PPU words per 60-bit CPU word. 

The format of the control table is: 



59 



Name 



41 



35 



00 



fwa 



23 



11 



0000 



length 



Bits 



59-42 



Field 



name 



41-36 


none 


35-24 


fwa 


23-12 


none 


11-0 


length 



Description 

Program name, l-to-3 display code characters, 
left-justified with zero fill. 

Reserved for future system use. 

Origin- 5; address at which header word is loaded. 

Reserved for future system use. 

Number of CM words in program image (1/5 the 
number of PPU words rounded up). 



4. 7 CM TABLES USED BY PP RESIDENT 
PP Resident uses the following CM Tables: 

1. PP Communication Area 
IR 



18 


1 


5 


36 


3-character PP routine name 


1 


C. P. # 


Parameters 
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OR 



12 


48 


Monitor Function 
Code 


Parameters 



MB 



6 CM words 



2. Resident Peripheral Library (RPL) 



RPL+0 





18 


6 


12 


12 


12 





program name 1 





Load Address 





Length 




first word 


of 


binary deck 


















i 


'■program name n 





Load address 





Length' 


n 


















3. Peripheral Library Directory (PLD) 



12 



12 



PLD+0 

1 



indicates end 
of library 



12 



program name 1 





Load address 


track 


sector 


program name 2 




Load address 


track 


sector 


program name 3 




Load address 


track 


sector 


program name 4 




Load address 


track 


sector 


program name n 




Load address 


track 


sector 







RPLA 


Length 
of SFP 


LA of 
SFP 



The last word of the PLD is a dummy entry. It forces PLL to load SFP. 

RPLA is the address in RPL of the routine SFP 
Length of SFP in CM words in RPL 
LA of SFP is Load Address of SFP 
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4.8 PP RESIDENT ROUTINE FLOWCHARTS 

The following flowcharts illustrate the PP Resident routines. 



IDLE LOOP 



rPPRJ 
•T" 



Read INPUT 
REGISTER 
address and 
INPUT 
REGISTER 



Set control 

point 

address 



•■■■ I 



Load 

program 

name 




"\ 






\ pause for re-/ 
\ location / 




18 



36 



TR = 



Yes 



Name of 
Program 


1 


C. P. 

assign 


arguj.ii en lS 



IR 



IR+1 



IR-f-2 IR+3 IR+4 



Yes 




Set 

DEL-AY 
= 77B 



DECREMENT 
DELAY 



; 1 LDD IR-1 get C. P. assignment 
LPN 37 save C. P. assignment 
SHN 7 shift left 7 for C. P. address 

STD CP save in cell CP 

2 This delay loop takes 128 microseconds 

; 3 LJM 5, LA 

LA contains the program load address 
the first 5 words of the program are 
loader information. 



Figure 4-2. PP Resident (PPR) 
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RPL = 

PLD = 
Direct Cell 



Program name 





Load address 





CM word length 












'Program name 


0*3 


Load Address 


track 


sector 


CM | CM 


+ 1 


CM + 2 


CM + 3 


CM + 4 




Read 1st 
entry in 
either 

RPL or PLD 



ENTRY (A) bits 0-11 = address advance instruction 
(A) bits 12-17 = library pointer address 
part of SLTB + SLTB + 1 = package name ■<- 1 
(LA) = Load address for zero overlays 




EXIT 



(A) = Load address if package found 

= if package not found 
(PLLA) = Load address if package found 
(T1-T2) = Address of package entry 



Return 
A) = Load 
Address 



Update 
entry pointer 
into RPL 
or PLD 



Read 
next entry 



: 1 Use initialization instructions in (A) in order to read either RPL or PLD. 
2 The package name was stored into the compare instruction at SLTB by PLL 

SLTB LMC * 
;= 3 ASR Equipment. 

Figure 4-3. SEARCH LIBRARY TABLE SLT 
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Store program 
name in dm 
part of LDC 
instruction 
at SLTB in 
SLT 



ENTRY (A) = Program name 

(LA) = Load address for loca- 
tion free routines 



NOTE: PLL is re-entrant for "PLD 
search" to provide the capa- 
bility to load the system M. S. 
Driver or M. S. error processor 
during the loading of a PP rou- 
tine from Mass Storage (M.S. ). 



Process (RPL) for a match 



Load initial- 
izing 

instruction 
in (A) for SLT 

ZH 




Load initializing 
instruction in 
(A) for SLT 



process (PLD) for a match 
*1 



Load package 
from RPL 
directly 
into PP 

memory, 



i —/+ 1 

r \ 

I Return J 




'■ 1 SLT uses these instructions to point at the proper table and to increment thru them. 
' 2 See SFP on page 4-22 



Figure 4-4. Peripheral Library Loader (PLL) 
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Save entry 
values for 
possible 
re-entry 



Load address 
EXR address 
PLL exit address 
Package name 



PLLB 
PLLC 
PLLD 
PLLE and PLLE+1 



Process PLD load 



FTN 



\ 



RSYM 



7 



SMS 



Request 
system 



See if proper M. S. driver for system device is in this 
PPU. If yes, initialize the driver. If no, load the proper 
driver (use PLL for the load) and initialize the driver. 



set mass 
storage 



POS 



position 
disk 




Yes 



RDS 



read sec- 
tor -»(T3) 



advance 
load address 

by 
477B 



Set next 
sector 
- (T7) 



(A) = FWA of data buffer 
= load address of PP 
routine each sector 
contains 100g CM = 
5008 ppu words. 



DCH 
drop 
channel 



Reset all 
infor saved 
at PLL1 



No 



new 

track 



Yes 




Set next 
track -»(T6) 
Set next sector 
= -♦ (T7) 



Return 









link 


eor 


SN 


link 


SN 


SN 
WC <r 100 


wc 


WC 






info 





if new track 



SN 


link ., ■ 


4XXX 


WC 


WC 









bit 11 is set 
other 1 1 bits 
are new track 
number -* T6 



SN = Sector number, WC = Word count 
*1 Example of program on RMS. 

Figure 4-4. Peripheral Library Loader (PLL) (Continued) 
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TftnJ 



Store MTR 
function 
in (CM) 



ENTRY 



EXIT 



(A) = MTk function 



VV.iVli-1, , 



CM +4) = Parameters 



(CM, . .., CM+4) = (OR) Output Register 
(FTNA) = (P), (AO), (BO) 



_L 



write (CM, 
.... (CM+4) 
into (OR) 





Exchange 
CPU 

MXN d 



Read 1st 
word of PPs 
exchange 
package 





yes 



:"TN\ 



Set 

DELAY 

= 77B 



yes *4 



Set (P) = PPR 
(BO) = 
[A5) = OR address 
(B2) = this PPs 
Exchange address 





*1 CPUL in CMR 

*2 is function < 36B 

*3 check (MA) for zero see Figure 2-4. 

*4 exchange area in CMR (BO) (AO) and (P) are from PXPP+1 in CMR which is stored into 5 

local cells in FTN. BO is set = 1477B so FTN can check if the exchange was honored. 

from D/S PRS; P VFD 24/PPR; AO VFD 13/0; BO VFD 6/0; LON 77 = VFD 12/1477B; hence 

BO = 18/001477B. See *6 
*S activate CPUMTR 
*6 has CPUMTR been activated 



Figure 4-5. Process MTR Function (FTN) 
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ENTRY 
EXIT 



(CP) = Control Point Address 



<£) 



(A) 
(RA) 
(FL) 
(CM,. 



CM 



= RA 

= RA 
= FL 
i-4) = CP status word 
(STSW) 



Read 
CMCL 
from CMR 




yes 



FTN 



A 



*1 



PRLM 



7 



Read CP 
status (STSW) 
control 
point area 




* 1 Pause for Storage Relocation 



Figure 4-6. Pause for Storage Relocation (PRL) 
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(rchj 



Store 
channel 
numbers 
in CM+1 



FTN 



ENTRY 



EXIT 



(A) = 1 or 2 channel numbers *1 
(CM+2) = additional channel numbers 
(if more than 2 needed) 

(CM+l) = assigned channel 



Reserve channel function 



RCHM 



Return 



Store 
channel 
number 
(CM+1) 



RELEASE CHANNEL (DCH) 



©ENTRY 



(A) 



channel number 




FTN 



Release channel function 



DCHM 



( Return J 



1 RCHM will assign one of the channels requested if it can. (A) and (CM+2) are 
used for optional channels 



Figure 4-7. Reserve Channel (RCH) 
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FWA msg 

(Tl) 
msg code 

(DFMA) 



Save 40 
characters 
of message 



Set msg 
code 

(CM+1) 



ENTRY 



(A) bits 0-11 = FWA of message 

12-17 = message control word 



The message is terminated by a 0000 byte. 
Messages longer than 40 characters will 
be sent in 40 character blocks. 




Restore 
everything 
saved 



DFM7 
Save direct 
cells 1-17 
save M. S. 
driver 



*2 



• 1 Dayfile message function 

■2 1DD may use a different driver to dump the dayfile and the original M.S. 
driver must be reloaded for the user. If dayfile dump required, then enough 
PP bytes must be saved for the part of 1DD which is loaded above PPFW and 
destroys that portion of the calling routine. These bytes are saved in the day- 
file dump buffer in CMR. CPUMTR assures only one PP will do a dayfile dump 
by not clearing the OR of a PP until the dayfile dump buffer is clear. 



Figure 4-8. Send Dayfile Message (DFM) 
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Dayfile Message Options 



Dayfile message options are: 

A normal dayfile message is sent to the master dayfile, control point dayfile, and control 
point message area. The "job name" is defined in the control point area. 





- 00000 


NMSN 


- 10000 


JNMN 


- 20000 


CPON 


- 30000 


ACFN 


- 40000 


AJNN 


- 50000 


ERLN 


- 60000 


EJNN 


- 70000 



NORMAL MSG. 

NORMAL MSG. WITH NO MSG AT CTL. PT. 

MSG. TO MASTER DAYFILE ONLY, WITH JOB NAME 

MSG. TO CTL. PT. DAYFILE ONLY 

MSG. TO ACCOUNT DAYFILE ONLY 

MSG. TO ACCOUNT DAYFILE WITH JOBNAME 

MSG. TO ERROR LOG ONLY 

MSG. TO ERROR LOG ONLY WITH JOBNAME 
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ENTRY (A) = Routine name 

(LA) = Load address for location free routines 



EXIT 



Exit to called routine via simulated return 
jump from caller 

Example: Call overlay 2XY 




(A) 

(LA) 

RJM 



2XY 

load address 

EXR 



z 



PLL 



\ 



load 
routine 



Set return 
address 
from caller 
-»(LA)+6 




then core from (LA) to (LA) + 7 is 

(LA)+0 2X 

1 Y- 

2 load address 

3 

4 length 

5 0100 LJM 

6 return address from caller of EXR 

7 1st executable statement address 

program 2XY at completion does a RETURN, 
which is a LJM (LA) + 5, which will LJM (re- 
turn address from caller). 



Figure 4-9. Execute Routine (EXR) 
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4.9 MASS STORAGE DRIVER RESIDENT AREA 

Mass storage drivers are overlays loaded by PP Resident in an area between PP Resident 
and the first word address of PP programs. Mass storage drivers are coded such that the 
entry points remain constant between all drivers. 

Parameters passed to the driver are: 

(T4) = Channel 

(T5) = Equipment number 

(T6) = Track 

(T7) = Sector 

The rules are: 

• Name = A "6" followed by the equipment mnemonic 

• Origin = "MSD" 

• First word = Driver identification, i. e. , the last 2 characters of the driver 
name. 

• Fourth word = A jump to the driver initialization routine. This entry is used 
by "SMS" to cause initialization of the driver. Exit from initialization is to 
"SMSX". "SMS" enters the initialization routine with (CM - CM+4) = EST 
entry. 

• The entries for read, write, and position origined at the appropriate symbolic 
names, i.e., "RDS", "WDS", "POS". These entries are entered via return 
jump, and due to the definition of the names, transfer code is necessary. 

• The number of sectors /track (2 numbers) origined at "SLM", 

• The driver must not use any direct locations except Tl, T2, CM - CM+4, LA. 

• The driver and its associated error processor must reside in RPL. 

All drivers are overlayed in this area, and use the following three entry points. 

POS - Position disk. 

Must be called on every track switch 

Entry driver initialized (SMS called). 

(T4) = Channel 

(T5) = Equipment 

(T6) = Track 

(T7) = Sector 

Exit None. 
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RDS - Read sector 

Entry driver initialized (SMS called). 

(T4) = Channel 

(T5) = Equipment 

(T6) = Track 

(T7) = Sector 

(A) = FWA of data buffer. (502 *1 word buffer needed.) 

Exit (A) = -0, if unrecoverable error. 

WDS - Write sector 

Entry driver initialized (SMS called). 



(T4) 


= Channel 


(T5) 


= Equipment 


(T6) 


= Track 


(T7) 


= Sector 


(A) 


= FWA of data buffer. (502 *1 word buffer needed.) 


Exit (A) 


= -0, if unrecoverable error. 



All drivers begin at location 600. 
600 ORG MSD 

600 0000 CON Cleared indicator to cause initial load 

! Use of mass storage drivers is described in detail in Section 7. 



*1 For all MS except 808 these are 502 word buffers. 

For an 808 it is a 503 word buffer. Hie extra byte is the expected head position and if it 
does not agree with actual head position after a Read, we have a Read error. 
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TABLE 4-3. SYMBOLS USED IN CONJUNCTION WITH MASS STORAGE DRIVERS* 



Symbol 


Value 


Description 


MSD 
SLM 
POS 
WDS 
RDS 

Symbol 


600 MASS STORAGE DRIVER IDENTIFICATION 
661 (MSD+1) SECTOR LIMITS 
606 (MSD+6) POSITION DISK 
612 (MSD+12) WRITE SECTOR 
616 (MSD+16) READ SECTOR 

OTHER MASS STORAGE PROCESSING CONSTANTS 
Value Description 


BFMS 
FSMS 

Symbol 


7000 SECTOR BUFFER ADDRESS 
1 FIRST DATA SECTOR OF FILE 

SYSTEM SECTOR ADDRESSES 
Value Description 


FNSS 
EQSS 
FTSS 
FASS 
DTSS 
EISS 


BFMS+2 FNT ENTRY (5 LOCATIONS) 

BFMS+2+5 EQUIPMENT NUMBER 

BFMS+2+8 FIRST TRACK 

BFMS+2+11 ADDRESS OF FST ENTRY 

BFMS+2+12 PACKED TIME/DATE 

BFMS+2+20+5 EOI {END OF INFORMATION) 

SECTOR NUMBER OF THE LAST TRACK IN THE | 
FILE CHAIN 1 

MASS STORAGE DRIVER ENTRY POINTS 1 

MSD AND SLM ARE READ ONLY CONSTANTS 

ALL OTHER ENTRY POINTS ARE ENTERED BY A RETURN JUMPI 

1 1 



^Whenever a PPU program desires to read or write mass storage, the program always 
executes a return jump to SMS. A flowchart of SMS is illustrated in Figure 4-10. 
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ENTRY 

(SMSJ 

V^y 111111 6 

EST 

entry 



(T5) - EST ordinal 
3 3 3 3 1, 



11 



12 





















device 1 address/ 10 
type of 

1 MST 



CM I CM+1 



I 



CM+2 



CM+3 



CM+4 



Read EST 
entry 

-* (CM) 



*1 




yes 




All initialize routines for all 
drivers begin at MSD+3. These 
routines set channel, equipment 
and select codes into all the 
driver instructions that use them. 
The initialize routine return to the 
original caller of SMS, which will 
UJM to PRS of driver. 



EXIT (CM, .... (CM+4) = EST entry 
Driver loaded if necessary 
Driver initialized 

(T4) = (CM+1) = channel number 
(CM -CM+4) = EST entry 



set driver 
name in (A) 
and device 

type in MSP 




PLL 



A 



load 
driver 



* 1 ESTS = FWA of EST 

*2 SMS has stored the device type of the present driver in (MSD = 600B) when that 
driver was loaded. So that it can compare EST device type in (MSD). 



Figure 4-10. Set Mass Storage (SMS) 
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4.10 SPECIAL FUNCTION PROCESSOR (SFP) 

Narrative on how SFP is called and what it accomplishes. 

In order to understand the SFP autoload this description of the CRM instruction is given here, 

CRM 
51 d M 



read (d) CM words from ft! toM 



1. 



(A) s CM address 

(TO)= (?) 

P = PP address 

Q = (d) - number of CM words to read 

K * TRIP count + op code 



K is a 9 bit reg 



TRIP 


1 
2 
3 
4 
5 
6 
7 



set up store P in TO and M in P 

read CM address into pyramid 

store byte into PP address (P) 

store byte 1 into (P) + I 

store byte 2 into (?) + 2 

store byte 3 into (P) + 3 

store byte 4 into (P) + 4 

increment (A), increment P, decrement when Q = 0, quit 



Read PYRAMID 



Store at TRIP count 



12 



48 



2 «- 

3 «- 

4 4- 

5 «- 



12 



36 



12 



24 



12 
— T 



12 



6 4- 



12 

or 
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PLL calls SLT to locate the entry in the PLD which matches the requested PP routine. 
18 . _6_ 12_ 12 12 



PLD+0 

+ 1 



name of PP program i 



name of PP program 2 







rr 



-r-q 



Sector 







Load Address 



Track 



Sector 



RPLA 



Length of 
'SFP 



LA of SFP 



last 



entry 



PLD+n, the last entry is a dummy. SLT reads each PLD entry in 
(CM,..., CM+4). 

Soj when SLT reads the last PLD entry 

CM+0 = 00 

+ 1 = top 6 bits of RPLA normally = 

-t-2 = lower 12 bits of RPLA 

+3 = CM word length of SFP 

+4 = LA of SFP normally = 1073 

RPLA is the location in the RPL of the entry for SFP. 
SLT discovers that CM = so he exits with (A) = 

Now, PLL continues with the instruction following the call to SLT. 

NJN PLL1 

Since (A) = 0, this jump is not taken and the next set of instructions will set up the auto 
load of SFP. (Location 157 in PP Res as of 8/24/73) 

LDN SFPL set CMR address of SFP auto load code in 

(A) 
CRM -3,ON read 1 cm word from CM address SFPL into 

PP memory starting at PP address 7774B. 



The read sets the following locations 
CRM (LA), ON 
LJM (LA) 

CON 7773B 



7774 S170 

7775 1073 

7776 0100 

7777 1073 
0000 7773 



This is not direct cell LA but actual load 
address of SFP hard wired to 1073. 



At the end of the read (A) ='SFPL + 1 since CRM increments (A) by the number of words 
read. During the CRM instruction the (P) are stored at (TO) = location 0000. The read 
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however forced the constant 7773B in (TO). Now, when the read completes, (TO) is incre- 
mented by 1 and stored in (P). So (P) = 7774B. This causes the next instruction to be 
executed at 7774B. (i. e. , an immediate transfer to location 7774B. ) 

j Now the CRM (LA) ON reads 1 word from CM address SFPL + 1 into PP memory at location j 
(LA) = 1073B, at the end of the read the LJM transfers us to location 1073B. 

The CRM LA, ON sets the following locations. 

1073 0000 PSN 

1074 20XX LDC RPLA which is the FWA in RPL of the routine SFP 

1075 XXXX 

| 1076 6113 (CRM) LA, (CM+3) (CM+3) still set from the read in SLT that started this 
' 1077 YYYY sequence, has the CM word length of SFP in RPL. 

The LDC instruction loads SFP RPL address in (A) and the CRM reads all of SFP into PP 
j memory starting at location (LA) = 1073B. The (P) is set to 1100B (i. e. , last instruction ' 

at 1076B and 1077B + 1 = 1100B) and SFP starts executing. 

SFP is a function processor which is called by the PPR subroutine PLL whenever PLL is 
unable to find a requested PP program. SFP will check the requested PP package against 
a table of acceptable PP package calls and, if legal, will call the associated function 
processor to process the request. The function processors are designed to provide SCOPE 
3. 4 capability. 

Call: 

SFP is called directly by the PPR subroutine PLL. 

Entry conditions: 

(IR - IR+4) = original PP program call. 

Functions: 

The following are those PP packages who have an associated function processor-. 

STS - SCOPE 3. 4 STATUS PACKAGE 

RPV - SCOPE 3.4 REPRIEVE CENTRAL PROGRAM 

MSD - SCOPE 3.4 SDA/SIS MESSAGE GENERATOR 

PFE - SCOPE 3.4 EXTEND/ALTER FUNCTION 

ACE - SCOPE 3. 4 ADVANCE CONTROL CARD \ (SFP) 

CKP - SCOPE 3. 4 CHECKPOINT 

REQ - SCOPE 3.4 REQUEST CALL 

DMP - DUMP FIELD LENGTH 

PRM - SCOPE 3. 4 PERMISSION CHECKING FUNCTION 

D00 - SCOPE 3. 4 ERROR TEXT PROCESSOR 

NOTE 
Functions are discussed in Section 26. 
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Dayflle messages; 

"XXX NOT IN PP LIB. " = PP package XXX was not found in PP libraries 

"XXX NOT IN PP LIB - CALLED BY YYY. " = PP package XXX was not in PP libraries 
and was called by YYY. 

"SFP/XXX PARAMETER ERROR." = Parameter address outside FL. 

"SFP.XXX ILLEGAL ORIGIN CODE. " = Function illegal for users job origin. 

"SFP CALL ERROR. " = SFP not loaded by default. 

The function processor table format follows: 



TFCN - table of function code processors. 
ENTRY = 4 WORDS: 

12 



TFCN+0 


PP1 




6 6 


+ 1 


PP2 OV 




12 


+2 


Addr 




lm 


+3 


bits 



PP1 - 1st two characters of PP program name 

PP2 - last character of PP program name 

ov - overlay name 

addr - address of function processor 

bits - bit 11 = check bit. If set, check is performed on bits 0-17 

of call for residence within users FL, else bit - 5 = job origin 
code bits. 



Symbols 

STS 

MSD ■ 

RPV 

PFE 

ACE 

PRM 

CKP 

REQ 

DMP 

DOO 



Legal Scope Processors 
Description 

STATUS PROCESSOR 

SDA/SE3 MESSAGE GENERATOR 

REPRIEVE PROCESSOR 

"ALTER" FUNCTION 

ADVANCE CONTROL CARD 

PERMISSION CHECKING FUNCTION 

SCOPE 3.4 CHECKPOINT REQUEST 

SCOPE 3.4 "REQUEST" 

DUMP FIELD LENGTH REQUEST (URA) 

ERROR TEXT PROCESSOR 
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process 
request 



Return 



1 SFP may only be called by PLL and not directly for a CP or PP routine. 



Figure 4-11. SFP Special Function Processor 
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This is not the PP initialization routine. 




Checks the PP package for which "PLL" could not find 
the associated routine against a table of special functions 
acceptable. If package acceptable as special functions, a 
check is performed for valid function code and parameter 
address within user area. 

ENTRY (IR) = address of requesting PP program 

(MA)- CM address of PP package name that 
"PLL" was unable to find. 



pause 



EXIT 



(SFPA) 
(SFPB) 



function processor name, 
function processor entry address 



check for legal SFP call 
j 



Read IR 
get PP 
call name 




dayfile 

error 

message 






Exit 



* 1 SFP may only be called by PLL and not directly for a CP or PP routine 

* 2 any error detected by PRS will cause the PP to be dropped and control returned 

to PPR. 



Figure 4-12. Preset Routine (PRS) 
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check for legal PP package call 




Load 
PP package 
name from 
(MA) 



Set function 

table address 

T6 



no 



Store PP 
package 
name into 
compare 
instruction 



*2 




Step to next 
entry in 
table 




end 

of table 



yes 



dayfile 

error 

message 



Exit 



: 1 uses T6 indirectly to get table entry 

-2 compare instruction at PRSA LMC (compare name) 



Figure 4-12. Preset Routine (PRS) (Continued) 
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check origin code for legal operation 



(j PRS) 



get job name 
from control 
point area 
(CP)+JNMW 



get origin 
code from 

JNMW field 




legkl 
origin 
code for 

this 
function 





yes 



PRSl 



Figure 4-12. Preset Routine (PRSXContinued) 
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Legal function check parameters and jump to function 




Set 

function 
processor 
address 




no 



Get 

parameter 
address in 
CM 



Is 
-CM address^ yes 
within callers 




some processors are in the main overlay with 
PRS, the others are in subsequent overlays. 
PRS itself can be completely overlayed. 



~n Return 



1 note that this processor was originally a PP request issued from some CPU program. 



Figure 4-12. Preset Routine (PRSXContinued) 
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JOB PROCESSING 



5 . INTRODUCTION 

All jobs which flow through the system, whatever their type, will be processed from start 
to finish by 1SJ, LA J, 1CJ, IRQ, 1RI, and (in the case of TXOT) also by 1TA. Flow is con- 
trolled by the queue priorities, CPU priorities, in association with time and equipment limits. I 
Depending on the resources desired by the job, all action is initiated, controlled, and 
eventually error- or end-processed by these five routines. 



All jobs are one of the following: 
Code 



Description 



= SYOT 

1 = BCOT 

2 = EIOT 

3 = TXOT 

4 = MTOT 



System — all jobs entered by the operator at the system 
console, such as DIS, FST, MY1, STAGE (OPL. T-50), 
etc. 

Local batch — jobs entered from all local batch devices. 

Remote batch — all jobs entered from the remote low 
speed (EI200 UT) batch terminals . 

TELEX— all jobs entered via the time- sharing executive 
program, TELEX. 

Multi- terminal — all jobs which do one specific task for 
many terminals while only being scheduled into the system 
once. 



Figure 5-1 illustrates the general system flow for jobs. 

5. 1 GENERAL JOB FLOW 

The priorities are controlled dynamically at the operators console and updated by ISP 
(Section 6) which is called by 1SJ. The Job Control area (JBC) in CMR stores the current 
values of these priorities for the system. Each job can be further restricted by the 
VALIDUX file, PROFILO file, or job card parameters, but no job can be less restricted 
than the JBC. ISP also updates queue priorities in the input and rollout queues, and 
periodically calls 1CK to checkpoint all MS devices . 
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Input Queue - List of jobs to 
be processed 



CR 



"^ 



Job 
Deck 



Mass 

Storage 

Device 





Listable 
Output 


f 




\ 




s 






LP 


s 











Control Point 



Output Queue — List of jobs to 
be disposed 



Figure 5-1. General System Flow 
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they sit in the input queue, they are aged (i.e., the queue priority is increased until it 
reaches the Upper Queue Priority (UQP), at which point the priority can be raised no 
further). At anytime, the scheduler, 1SJ, may determine that this job is the best candi- 
date (best job) for a control point by an algorithm that takes into account queue priority 
and resources desired (FL, etc.), and attempts to schedule or assign it to a control point 
(Figure 5-3). In order to do this, it will see if there is enough unused core available to 
satisfy the field length requirements for the job. If not, it will see if there will be enough 
after scheduled rollouts of other jobs. If not, it will attempt to schedule any other jobs 
with lower priority than the best job. If there is no way to get enough FL, 1SJ will drop 
When it is subsequently called again, it may or may not pick the same job as the best job. 
If there is enough FL, 1SJ looks for an available control point. If there isn't one, he will 
schedule for rollout any jobs whose priority is lower than the best job. If there are none, 
1SJ drops out. When 1SJ assigns the best job to a control point, it will get the FL, set 
up the control point area (CPA) with information from the VALIDUX, PROFILO, and JBC 
areas, and will set the input queue priority to (UQP) regardless of what it was when picked. 
1SJ will leave the job in no operation status "W", "X", "R" = zero by setting STSW in CPA = 
0, and then will call 1AJ (Figure 5-4). 



I 




* 1 



JOBNAME 



I 



Input Queue Entry 



* 1 TXOT/MTOT are started by TELEX 
and SYOT is initiated by DSD. 



Figure 5-2. Read Card Reader 
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Figure 5-3. 1SJ Prepares a CP for the Job 
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CPA 




Input 



Read 1st Control Card 
Loads 1st Routine starts 
Job 



Figure 5-4. 1AJ Starts the Job 

1AJ, the job advancement routine, will note that the job status is empty, i.e., last opera- 
tion complete (in this case first operation is not started) . He will call 3AB, an overlay to 
start this job up. The job can at anytime create local files, and if the name is OUTPUT, 
PUNCH. PUNCHB, or P8 it will be treated special at job completion time (Figure 5-5). 

As the job progresses, CPUMTR and MTR will periodically check all the jobs running at 
control points and, if either detects "W", "X" and "R" status zero, they will call 1AJ. 
If the error flag is set, 1AJ will process the error. If the error is not fatal 1AJ will advance 
to the next control card. If the error is fatal but an EXIT card exists, then 1AJ will 
advance to the card following EXIT. CPUMTR and MTR also monitor the CPU time-slice, 
and if the job exceeds its time -slice, its queue priority is dropped to the Lowest Queue 
Priority (LQP) of that type. This does not mean that the job will lose its control point. 
If 1SJ finds a best job in the input or rollout queues, then low priority jobs are candidates 
for rollout. Also 1SJ monitors all the control points, and, if it detects that the CPU 
time-slice is exceeded before either monitor detects this, 1SJ will lower the queue 
priority to LOP. An interlock is provided in bit 35 of TSCW in CPA so QP is only dropped 
once. 
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Optional 



CPA 



. FL 




Input 



Output 



CP 

# 



CP 



Figure 5-5. Job Creates Local File Name OUTPUT 

PUNCH, PUNCHB or P8 - Denoted by OUTPUT type O, 
however the type will be PRFT or PHFT . 

IRO may be called by 1AJ, 1SJ, DIS, Special Entry Point (SEP) calls or some other routines 
(Figure 5-6). IRO will dump the job according to the rollout file format (Figure 5-9), will set 
"W", "X", "R" status to zero, will request the control point be made available, and will 
release all FL, non-alloca table equipment, i.e. , tapes are not released but CP number In est 
is set to 37B, and all files assigned to this control point. The job is then placed into the 
rollout queue with whatever queue priority the job had when rolled out. If IRO is called by an 
SEP, the rollout file will be called DM* and left assigned to this control point. IRO will 
release everything else except the input and control card file, and will call 1AJ to advance the 
job. In this way FNT space is not wasted while a job is rolled out. 

1RI will read the rollout file and re-establish all the files, equipment, etc. to allow the job to 
continue (Figure 5-7). It will set "W", "X", "R" status to its former values. The control 
point will now be a candidate for the CPU . 

One can say categorically that a job always gets a fresh time slice when it is rolled in. In 
fact, some problems can occurr because of this. If a grinder BATCH origin type job were executing 
in the CPU, and TELEX origin jobs were constantly bumping it because of higher queue priority, 
the system always schedules the job back in ASAP since it left with Upper Batch priority with a 
new time slice. In fact, in a busy system, this BATCH job would never exceed a time slice and 
would cost system resources by constantly rolling in and out. 



When 1AJ detects an end-of-job card stream, a fatal error with no recover, an illegal control 
card, or some other fatal condition, it calls 1CJ to complete the job. If any of the job flow 
routines ever detect a type which is not defined (i.e., type not SYOT, BCOT, EIOT, TXOT, or 
MTOT), it will call 1CJ immediately to end the job. This is protective coding. 
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1CJ will locate the local file OUTPUT assigned to this job, if it exists (Figure 5-8). It will 
then append the job dayfile to the end, write an EOT, and move the file to the output queue, 
by setting the GP # to zero . 



MTR finds a CP in rollout requested status and issues a JACM to call 1AJ. 



Optional 



CPA 



FL 




* 1 And any other Local Files 

* 2 This is the same FNT entry 



Figure 5-6. Job Is Rolled Out 
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JOHN A ME R 



* 3 



INPUT 



CP 



OUTPUT 



CP 
# 



f 1 



* 1 And any other Local Files 

* 2 Not necessarily same CPA & FL as Figure 5-6 

* 3 This is the same FNT/FST entry 



Figure 5-7. Job Is Rolled In (From Rollout) 
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MTR finds a C? in zero status 



CPA 




FL 












' 




~N 


' 


1 







JACM 



Release 
CPA & FL 




* 1 



Change OUTPUT File name to 
JOBNAME and Type From L to 
O. Append Dayfile onto end of 
OUTPUT File. 

1CJ Also Returns All Files Associated 
With this Job Except OUTPUT Type 
Files. 



* 1 Same FNT/FST Entry 
as Local OUTPUT File 



Figure 5-8. Job Completes 
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5.2 S YSTE M PHILOSOPHY 

System philosophy is the description of the concepts relative to rollout file tags, scheduling 
and sequencing, system sector data location, ageing, and control cards. 

5.2.1 Rollout File Tags 

Rollout file tags are defined in the common deck, COMSJRO. 1RO, 1RI, and 1TA are 
the only routines that currently use the common deck. 

5.2.2 System Sector 

The system sector (Sector 0) for a rollout file contains the following information: 

(These symbols are defined in COMSJRO. ) 



• Dayfile buffer pointer 

The dayfile buffer pointer consists of two words, an exact image of the 
control point dayfile buffer pointer words from CMR. 



Tag Value 
DFBP 50 



Defined Value 
10*5 



Description 
Dayfile buffer pointers 



• Input file FNT entry 

This consists of a copy of the input file FNT/FST entry. It is zero 



if no input file is present. 

Tag Value Defined Value 

INFE 62 DFBP+2* 5 



Description 
Input me FNT 



Assigned equipment 

This consists of a list of the equipment assigned to the job. The list is 
terminated by a zero word. 

Tag Value Defined Value Description 

AEQE 74 INFE+2* 5 Assigned equipment 



Terminal table information (TXOT only) 

The tags for this are TISS and TTSS, where TISS is the terminal table 
contents at the last rollout, and TTSS is the terminal table contents for 
the last recovery. 



Tag 

TISS 
TTSS 



Value 

240 

360 



Defined Value 

40*5 
TISS+20* 5 



Description 

Terminal table 
Terminal table 
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5.2.3 Rollout Pile (Figure 5 -3) 

The sequence of the rollout file follows: 

• Control point area 

The control point section is two sectors in length, and is an exact 
image of the control point area in central memory. 

Tag Sector Sequence Number Description 

CPAI i Control point area 

• Dayf lie buffer 

The dayfile buffer section is one sector in length, and is an 
exact image of the dayfile buffer in central memory. 

It is possible to change the dayfile size for the system dayfiles , 
but the job dayfiles are fixed at 100B words p. II -4 -6 in Install 
Handbook CMRDECK, therefore only 1 sector for this buffer is 
needed in the rollout file . 

Tag Sector Sequence Number Description 

DFBI 2 Dayfile buffer 

• File name table 

The file name table section is n sectors long, terminated by a short 
sector (logical record). It contains a list of FNT/FST entries of 
files associated with the control point. The FNT entries are stored 
as two-word entries in this section. 

Tag Sector Sequence Number Description 

FNTI 3 File name table entries 

• Terminal output 

The output for a terminal is n sectors long, terminated by a short 
sector (logical record). This only exists for TXOT origin jobs. 

Tag Sector Sequence Number Description 

TOPI 4 Terminal output 

• Job field length 

The job field length section is n sectors long, terminated by the EOI 

sector, and is an exact image of the job FL in central memory (n = FL/100B). 

Tag Sector Sequence Number Description 

JFLI 5 Job field 

MXFI 6 Job field 
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TAGS 

DFBP 

INFE 

AEQE 

TISS 

TTSS 

CPAI 
DFBI 

FNTI 

TOPI 

JFLI 



MXFI 



SYSTEM SECTOR 

. Day file buffer pointers 
. Input file FNT 
. Assigned equipment 
. Terminal table* 1 



CONTROL POINT AREA 
200 CM words 



DAYFILE BUFFER 
100B CM Words 



FNT/FST ENTRIES 



TERMINAL OUTPUT 



*1 



JOB FIELD LENGTH 



1 Sector 

2 Sectors 
1 Sector 



X Sectors 

*2 
eor 



m Sectors 

* 3 
eor ° 



n Sectors 



eoi 



* 1 exists only for TELEX origin jobs 

* 2 tells 1RI when all FNT entries are accounted for 

* 3 tells 1TO when all the terminal output has been issued CIO 

has a trap for terminal output and will call 1RO instead of 
sending this output to the output file 



Figure 5-9. Rollout File Format 
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5.2.4 Priority Aging 

A job of a particular job origin type waiting in the input, rollout, or output queue is aged 
if its current priority falls between the lower priority and the upper priority limits . 

A job Is aged by the scheduler in conjunction with the job control area parameters in 
GMR. The job control area word illustration follows: 

59 47 35 23 11 



IBC 



For each cycle of the priority increment routine (ISP), the counter (byte 4 of JBC) is in- 
cremented by one. This continues until the counter is > the age increment (byte 3 of JBC) . 
At that time, the job queue priority is aged by one. 

an r*sr> ««— ,™„„.j = TODnirrir ^r.+».-i=o -,„,} t«k r-,-.r,+^«i ^f^ms^inn <•= in +h= rrtt cruris 
2.1 Installation Handbook, Publication Number 60407500A. Specifically, the student 
should read Sections 5 through 7. 



INITIAL 
QUEUE 
PRIORITY 


LOWER 
QUEUE 
PRIORITY 


UPPER 
QUEUE 
PRIORITY 


PRIORITY 
AGE 

INTERVAL 


CURRENT 
INTERVAL 

COUNT 



5.2.5 Queues 

The Queues (Input, Output, Rollout, etc. ) are not separate areas in CMR, but are actually 
FNT/FST entries in the FNT/FST table area of CMR. When a routine checks a queue, it 
is actually reading through the FNTs finding those entries that have the type they are seek- 
ing but not assigned to a control point. 

When a job is moved from the input or rollout queues to a control point, the lfn field of the 
FNT word contains INPUT instead of JOBNAME. The control point assignment field is set 
to the control point number and the QP is set accordingly (Upper Input or Rollout priority). 

When a job is sent to the rollout queue, the FNT name contains JOBNAME instead of INPUT. 
The type is Rollout, the control point assignment field is set to zero, and the QP is set to 
whatever the CPA held at rollout time. 

When a job completes* the FNT name (OUTPUT), if one exists, is changed to JOBNAME. 
The file type is changed from Local to Output, the control point assignment field is set to 
zero, and the QP is set accordingly (Initial Output type priority). 
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5.2.6 Rollout Scheduling 

When a job is scheduled for rollout, the rollout-request flag, bit 24 in JCIW of the CPA, 
is set and 1RO may or may not be called. When 1RO is called (by ROCM) it sets the roll- 
out-in-progress flag, bit 27 in JCIW. When 1RO has rolled the job out, it will reset 
these bits to zero. Also, if 1RO was called by Special Entry Point routine (SEP), 1RO 
will set these flags to zero. Also note that an SEP job can be scheduled to be rolled out 
also. In this case, when 1RO is called, it is a regular rollout, not a response to an SEP. 

Many copies of 1RO and 1RI can be run simultaneously, but there is a maximum number to 
avoid PP saturation. 

5.2.7 Scheduler 

Only one copy of 1SJ may run at any one time, and this can only be called by the monitor 
function, RSJM. 1SJ will continue to cycle as long as an RSJM is issued during one of 
its scans. 1SJ will only cycle some maximum number of times in order to ensure smooth 
operation. 

The philosophy of 1SJ is that any time the status of the system changes, 1SJ should assess 
the status and modify flow as needed. However, if ten changes occur during one 1SJ 
cycle, 1SJ is only .needed once more (not ten times more) due to the fact that the assess- 
ment is made on the total system status, not on just one part. Even if a best job does not 
get in on one cycle, and may get passed over for the next several cycles due to other 
higher priority jobs entering the queues after it was picked, it will eventually get to a control 
point. This is better than queueing up best jobs and saves 1SJ from having another table 
of priorities to assess, therefore wasting valuable system resources. In a normal mix, 
eventually all jobs will be scheduled and any minor delay for one particular job will be 
inconsequential to the throughput of the system in a day. 

Figure 5-10 illustrates a typical queue priority scheme. Note that subsystems are 
greater than MXPS+4 (MXPS=7760). Certain jobs which require that they cannot be 
rolled out use priority MXPS+1, 2 or 3, such as Permanent File Manager, Local File 
Manager, etc. 
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CD 
-J 



-J 
O 
O 

to 



Queue 
Priority 



7000 



G00O - 



4000 - 



3000 



2000 



1000 



0000 



Input Queue 
SYOT BCOT EIOT TXOT MTOT 



IIQ 



UIQ 



UQ J 



UIQ-. 



UIQ 



UIQ-i 



IIQ 



IIQ- 
LIQ 



UIQi 

IIQ 
LIQ 



IIQ - LiQ J 



LIQ 



Rollout Queue 
SYOT BCOT EIOT TXOT MTOT 



UHQ 
URQi HtQ - 



IRQ-i 



URQ- 



LRQ J 



IRQ - 



LRQ 



Output Queue 
SYOT BCOT EIOT TXOT MTOT 



UOQ 



URQt UHQ 



IRQ 



LRQ J 



IRQ- 
LRQ 
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IOQ- 



UOQi 



UOQ 



IOQ 



UOQn 



IOQ 



LOQ J LOQ J LOQ-' LOQ J LOQ 



IOQ 



UOQ 



IOQ 



Figure 5-10. Typical Queue Priority Scheme 



5.2.8 Control Cards 

1AJ has an overlay called TCS which can be called directly from a CP routine or by 1AJ. 
TCS (Translate Control Statement) will crack a control card and test it for validity. Each 
control card is actually a call to the system to load a routine whose entry point name is 
the keyword on the card, such as MODIFY, COPYBR, etc. TCS will assemble the 
arguments, if any, on the control card and make them available to the routine specified 
in the keyword. Now, a search is made to locate the routine. First, the FNTs locally 
assigned to this control point are scanned, then the RCL, then the CLP. If the routine 
is found in any of these, the first occurrence of the routine is loaded, and the arguments 
are sent to it, and it is started. (This allows a programmer the facility to define a 
local program/ routine to his control point which may exist in the system already. ) 
If the control card is preceeded by a $ ($MODIFY, $COPYBF, etc.), the local FNT scan 
is bypassed. 

If the entry point name was not found, the RPL and PLD are scanned. If found, the rou- 
tine is loaded into a PP (set IR = routine name and argument) and TCS goes away. 

If no match is found, an appropriate error message is issued to the dayfile and error 
procedures are initiated by setting the error flags and returning to 1AJ. 

Before a CPU program is given control, the loader will place the control card image which 
called this overlay into cells RA+70 through RA+77. Also, the control card which was 
cracked by TCS and the parameters found are placed in cells RA+2 through RA+63. If 
the control card was preceded by a "/"» the parameters are cracked in KRONOS format, 
otherwise they are cracked in SCOPE 3.4 format. All compiler (FTN, RUN, COBOL, 
etc.) binaries will expect control cards to be cracked in SCOPE 3.4 format. 



1) KRONOS format (6-bit ID code) 
42 



Parameter (7 characters) 



12 



ID 



ID = for all separators except " = " and "/". and in those cases the 
character is placed in the 6 bits . 



2) SCOPE format (4-bit ID code) 
42 



14 



Parameter (7 characters) 





ID 



Parameter = string of characters up to the separator 
ID = separator equivalence 
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1 
2 

3 
4 
5 
6 
7 
10 
17 



continuation (for literals) 



Space 
Termination ) or 









PGNR = RA + 64 = 


MODIFY 


11B 











For example, the control card 

MODIFY (I. P= ( 0, N=FILE, A. NR, X, CD 
would be passed as follows: 

KRONOS 2 . 1 

42 12 

RA+2 
3 
4 
5 

6 

7- 



10 
11 



I 







p 





= 


| 




N 





= 


FILE j 




A | 




NR 







X 







CL 







Binary Zeros 



6-bit code is display 
character when used 
and binary zeros when 
blank. 

Full word of zeros 
terminates control 
card. 



SCOPE 3 . 4 
42 14 



I 





1 


p 





2 








1 


N 


o 


2 


FILE 





i 


A 





l 


NR 


o 


1 
- 


X 





1 


CL 





17 


Binary Zeros 



4-bit code is binary 
number. 

One word of zeros preceded by 
other than a code 17 implies 
another control card. 



The flow chart (Figure 5-11) shows the flow of control card processing. 1AJ 
processes CTIME/RTIME directly. 
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NOTE 



Automatic parameter cracking depends 
on whether the load is from a system or 
local file. 



System Load 

Default is KRONOS 
unless *SC speci- 
fied in LIBDECK. 



Local Load 

Default is SCOPE 
unless "/" on control 
card. 



fSTARTJ 



Read a 
control card 



© 



0- 



Control card 
processor 
searches its list 
of control card 
names for special 
control card 




yes 



Search CPU 
library for 
control card 



name 



Process 
special 

request 





Search PP 
library for 
name, if name 
is legal PP 
•pfo'gTaaTname 




Found? \_ves_ 



Declare 
control 
statement 
illegal 



Search FNT 
for file 
assigned to 
this job 



© 



Process field 
length control 



Load program 
to central 

memory 



Store control 
statement and 
control statemem 
arguments in 
user's FL com- 
munication area 



[ Execute\ 
^program/ 



Place name 
with up to two 
octal arguments 
as a PP request 



f Exit to pro- 
|gram (no FL 
V change) 



© 



Local absolute files with multiple entry points cannot be 
loaded. However, local relocatable files with multiple 
entry points can be loaded. 
- ----- Denotes c hange for KRONOS 2. 1 

Figure 5-11. Control Card Processing 
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S . 2 . 3 Special file INPUT* . 

1 . When the user returns the file INPUT, INPUT* is set up to point to the input file, 
but the user cannot access it. 

2 . When a CALL (Procedure file) is encountered , the procedure file is expanded on 
INPUT*. 

3. When a procedure file from the system is encountered, a dummy CALL is generated 
to the CP processor CONTROL and the expanded file is pointed to by INPUT*. 

4. When any combination of the above occur, INPUT* is used for all of the above to 
link up the several "FILES". 

Note: the file INPUT* may not explicitly exist for point 2 or 3, i.e. , no FNT/FST 
entry, but may only be pointed to by CSPW in the CPA. See *5 bit 59 in figure 2-3 
word CSPW + 1 . 

5.2.10 Timed/Event Rollin Processing TEFT . 

Overview of TIMED/EVENT Rollin. When a CP program desires to go into timed/event rollout, 
it uses the ROLLOUT macro and specifies an event and/or a time. 1RO is called to roll the job 
out and create a TEFT FNT/FST. 



Job Name 


Orig 


TEFT 


1 





evt 

des 


eq 

no 


1st 
TRACK 


event 
description 


FL 


rollout 
time period 



12 



12 



12 



12 



When ISP is called by 1SJ it will check each entry in the TEFT queue and if the rollout time 
period has expired it will change the entry to proper ROFT. If time period is not expired, ISP 
will use the EATM monitor function to read the EVENT table from MTRs memory. It compares the 
events with this 1 8 bit event descriptor and if there is a match ISP will change the entry to 
proper ROFT as follows. 



Job Name 


Orig 


ROFT 


1 








eq 
no 


1st 
TRACK 


reserved 


FL 


Upper queue 
priority for 
origin code 



Only PP programs may access the EVENT table via the EATM MTR request, (see p. 4-9 of 
instant) Therefore, the macro EESET was designed. 
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EESET MACRO A where A is any 18 bit configuration this macro calls CPM to enter this event 
description A into the event table. Unfortunately, a job must have SYOT origin to use the EESET 
macro, see example 2. 

The only PPs using this function currently are: 

CPM for EESET enter event. See example 2. 

ORP to specify when a Write mode PF is not busy (i.e. , has no read users using it). See 

example 1 . 

QFA to specify when a Write mode FA is not busy (i.e. , has no read users attached) See 

example 1. 

1MT to specify when a VSN has been satisfied for RESEX. See example 3. 

5.2.10.1 DSD and DIS Commands. 

In all DSD file displays the timed/event rollout files will be displayed as TEFT file types. In 
addition, the Q display has all TEFT rollout files flagged by **. 

The DSD command, ROLLIN,XX. may be used to roll -in a TEFT Job. 

For a Job at control point n, the DSD command n.ROLLOUT.XXXX. will roll the Job out for XXXX 
seconds. 

This command to roll a Job out for a time period may also be used under DIS as follows: 
ROLLOUT, XXXX. 

5.2.10.2 Description of Timed/Event Rollout - 

The timed/event rollout feature allows Jobs to access system resources as they become 
available. Through use of the ROLLOUT macro, the user may request to be rollout out until an 
event occurs or time period expires. If the desired event does not occur within the specified 
time period, the Job will be scheduled to roll-in for further processing anyway. 

To determine when a specified event has occurred, a system event table is maintained in PP 
memory. System programs can make entries to this table to indicate occurrence of events. The 
Job scheduler ISP compares the requested event with the system events recorded in this table 
to determine if any matches have occurred. If a match occurs, the Job scheduler ISP initiates 
rollin. If no one is waiting for the system events they are cleared from the table. 
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5.2.10.3 ROLLOUT - Call format. See Reference Manual. 



ROLLOUT - macro follows . 

ROLLOUT - macro addr 

Entry - If addr is not specified, rollout job until operator initiates rollin. If addr is present, 



addr 



59 



29 



11 



evd 



Where: 

rtp = rollout time period in job scheduler delay intervals (0 < rtp < 7777B) . If rtp = the job 
rolls out for a time determined by the system to insure that the job will roll in if the event he 
is waiting for is lost or never occurs. 

evd = event descriptor. 

If evd is non-zero, the event descriptor and rollout time period, rtp, are placed in the control 
point area (UPCW) . When the job rolls out it will wait for the occurrence of the event in evd 
or the specified time period (rtp) to elapse before becoming eligible for rollin. 

If evd = 0, event is taken from control point area and only the rollout time period is taken from 
RA + addr. This option allows the user to rollout waiting for events that they system specifies. 

If evd = 7700XXB, then extended timed rollout is made. (Assume the Job scheduler delay is 1 
second) . Since the maximum time rtp can specify is approximately 1 hour and 8 minutes , the 
extended time rollout allows the user to roll out for any length of time. This is a strict time 
rollout with no event dependency. Job rolls out for (777*XX + rtp) seconds. 

5.2.10.4 Programming Notes : 

It Is possible for the central program to get the CPU before the rollout flag is detected by the 
system. In cases where it is necessary that the calling program know that the rollout has 
occurred, he should interrogate the UPCW word of the control point area. The lower thirty bits 
of UPCW = indicate that the job has rolled out and either the event required has occured or 
the time period has elapsed, i.e. , user needs to have RSB capability which is SEP. 
(See section 5.2.10.6.) 
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5.2.10.5 Examples: 

1. Attempted attach results in file busy. 

a) Assume error processing is set. Upon restarting the job, use of the rollout 
macro with evd = will rollout for time specified by rtp waiting for the event 
file ready to be accessed. (ORP enters this event in the system event table 
when the file becomes not busy. PFM stored the descriptor for this event in 
the control point area (UPCW) when it found the file busy but it did not set 
the rollout flag, allowing the user to choose whether to rollout immediately, 
or to process some other function first. 

b) If error processing is not set the job is automatically rolled out, waiting for 
the file to be ready to be accessed. When the job rolls back in, the ATTACH 
request is retried. 

6 12 

EVENT for example 



Unit 



1st track of file 



1 is: 

ATTACH Control Card: 

When a user attempts to access files that are interlocked, the system automatically suspends 
the job until the file becomes available. This is available for the ATTACH function only. 

The ATTACH command, and control card, automatically do this and the error flag is not set if 
the file is busy. The user may bypass this automatic suspension, by specifying the A option 
on the control card. 

If this option is specified ATTACH (Ifn/A, ) the system aborts the command if the file is 

busy. The user calling PFM via the macros provided, can bypass this automatic suspension 
by specifying error processing. If error processing is specified, the system returns control 
to the user with error status reflecting FILE BUSY. 

2. Job Dependency. 

Suppose that before JOB1 continues processing that he wants JOB2 (a system 
origin type JOB) to execute a certain function. Assume JOB1 uses the rollout 
macro with evd = 1300 and rtp = 600. The rollout flag will be set for JOB1 to 
rollout for 600 seconds or until event 1300 takes place. Before the 600 seconds 
has elapsed, suppose JOB2 makes the macro call - EESET 1300,* entering the 
event 1300 in the system event table. JOB1 will then be scheduled for rollin to 
resume processing. If 600 seconds elapse because event 1300 has not occurred 
(or the event was cleared from the table before JOB1 rolled out) , JOB1 will be 
scheduled for rollin. 

In any case, JOB1 will not know if it was rolled in because of time or event 
occurence. Hence, it is necessary for JOB2 to do something, for example write 
a code word on a PF which JOB1 can check to see if the event occurred. 
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This job dependency can be accomplished by JOB2 attaching a PF in write mode 
and then JOB1 doing the same. JOB1 will wait as in example 1 for JOB2 to release 
the file. However, if JOB2 gets the DPF first it must release the file for JOB2 and 
then attempt to attach it again. In order to use the EESET effectively, an installa- 
tion must change CPM to accept other origin types who issue EESET. This solution 
has a serious problem, which is possible filling of the event stack. So, a change 
to CPM warrants careful consideration by the installation to limiting the number 
of EESET requests per origin type. 

3. Tape scheduling with VSN. 

User asks for VSN specified tape. RESEX is called to make the request to MAGNET. 
Routine CUP in RESEX will issue the ROLLOUT macro and enter timed/event rollout. 

The event is a folded VSN (the sum of the 3 bytes of the VSN truncated to 12 bits, 
see Level 3 Release KRONOS 2.1 Newsletter p. 5. The rollout times are given on 
p. 4 of the above document). When the assignment is made, 1MT will enter the 
event with the EATM function. ISP will then schedule the job for rollin. 

Event for example 3 is: 
6 12 



76 ! Folded VSN or (for -commitment or at initialization 
to indicate MAGNET is ready.) 



See charter 9 for discussion of RESEX. 1 

i 

! 

5.2.10.6 The ROLLOUT Macro | 

1 
The ROLLOUT macro calls CPM function 6 CPM will read the rollout time and event from the 

users FL and store it into CPA + UPCW. CPM then does a ROCM. 

Control is then returned to the user. The user then can execute until the rollout bit is seen by 
MTR who initiates 1AJ, who calls 1RO. In order to insure the rollout, the user must issue some 
PP request, since CPUMTR will not honor a PP request for a CP scheduled for rollout. CPUMTR 
will place the CP in "I", auto-rollout status with an outstanding RA + 1 request. The simplest 
method is to build a dummy FET and issue the RETURN macro. This will issue an RA + 1 request 
to CIO. | 

MTR will notice that this CP is in "I" status and is scheduled for rollout, so it will call 1AJ, 
who calls 1RO. 

1RO will roll the job out and then look at CPA + UPCW. If it is zero this is a regular rollout. 
If it is non zero, tnen 1RO. 
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1RO will roll the job out and then look at CPA + UPCW. If it is zero this is a regular rollout. 
If it is non zero, then 1RO will build a "TEFT" type FNT and place the event and time limit from 
UPCW into the FST. 1RO then clears UPCW. 

When the Job rolls in, MTR will find the CP in "I" status, and an RA + 1 request. MTR will call 
CPUMTR with a zero request and CPUMTR will then honor the RA + 1 request. In the case of 
the RETURN dummy, CIO will treat it as a NOOP (file does not exist) and complete. Then the 
CP can continue. 

However, it does not know if it got rolled in for the time period or the event, so it is the users 
responsibility to insure the event occurs. See RESEX for an example of this above activity. 
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5.3 SPECIAL PROCESSING 

Special Processing is the processing of subsystems, special entry point jobs, and special 
RA+1 requests. 

5.3.1 Subsystems (SS) 

An SS is a special type of job with many privileges not granted to regular jobs within the 
system. Some of the privileges are: 

1) SS cannot be rolled out 

2) SS can make use of the inter CP communication special RA^l 
requests (SIC and RSB) and receiving and sending data buffers. 

3) SS can get a CPU priority above normal CP jobs 

4) SS need not be restricted by JBC or VALIDUX, however an SS 
must have a user index set in UIDW, in order to access permanent 
files. 

5) SS determines which CP to run at and storage moves any other 
job occupying that CP at SS load time. 

6) The SS has an implicit special entry point (SSJ = ) status 

7) SS can request the CPUMTR to load a PP routine whose name begins with 

a numeric (RA+1 call TLX). (Any PP request from a normal job must be for a 
PP routine whose name begins with a letter. Any other PP call aborts the CP 
program). 

In order for a job to qualify as an SS, it must: 

1) Have a Queue Priority (QP) greater than 7763 and be defined in 
SYSTEXT SSCL or SSCL+1 in CMR. 

2) Have an.entry defined in IDS so that it can be called from a DSD command. 

3) Have a unique QP, since it interacts with the system based on its QP and 
not on its user index or name or control point number. 

Job advancement, scheduling, and detecting an SS are different than for normal jobs. 
1RO normally cannot roll out any job with QP £ MXPS, therefore 1RO is the only job flow 
routine which does not need a trap for SS. 1SJ must trap the SS in order to ensure it 
a CP immediately and to assign it the QP. Since an SS normally has a very high CPU 
priority, an SS programmer must be careful not to be a hog and keep other users out of 
the CPU. 
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Since interaction of SS is very intimately associated with the system, and, in many cases, 
"hard wired in" , it is not very feasible to define a new one; however, since the system was 

I designed to handle 9 SSs, it is feasible to replace one with an SS of your own choosing. 
As an example, replace CYBER LINK with MYJOB. 

1) In SYS TEXT at Correction Identifier (CI), replace PPCOM. 53 
with MYPS EQU 7765 MYPS. 

12) In IDS for function 33 at (CI), replace IDS. 1217 with VFD 12/MYPS, 
18/0L1MY, 6/75B, 12/0 
where: 12/MYPS is QP from SYSTEXT. 18/0L1MY defines a 
start up PP routine. 6/75 defines a relative CP number where 1 
= CP1, 2 = CP2, 3 = CP3, and storage moves a job at that CP 
I if necessary. 77 = the last CP, 76 = the next to last CP, and 

75 = the second from last CP. However, if those CPs are occupied, 
one must take a CP that is even lower. 12/0 is a mask used by subrou- 
tine SSS in 1SJ to determine if a disable /enable bit is set in SSTL byte 2 in 
CMR. If mask = 0, then SS cannot be disabled. 

3) Write a PP routine called 1MY which must set up the control point 
area with queue and CPU priorities and other essential cells set. 
Then request a call to LA J. If inter-CP communication is desired, 
1MY will need to set up I CAW in the CPA, defining the transfer in 
and transfer out buffers . 

It can either set up a control card in the control card buffer area or 
put it into DSD's control card buffer area, and request 1AJ with function 0, 
process DIS buffer call. The control card should call the CPU overlay which will 
run as the SS. (The user should refer to 1TD routine printout for an example 
of these set up calls, CI 1TD 5812 through 1TD 5830, and 1TD 6023 through 
1TD 6032. 

4) Set up the DSD type-in entry for this SS in the DSD SYNTAX TABLES 9AX, 
9 AY, 9AZ, 9AO, or 9AW to recognize the type -in, MYJOB. (Refer to 

| Section 25). 

5) Modify'IPR, the IPRDECK analyser, to recognize that this SS can be 
| autoloaded, if desired. (Refer to Section 24). 

6) Set up the subsystem control word in byte 4 of SSCL+1 in CMR. 
Note that SSCL is allocated in 12-bit bytes which are allocated in 
decreasing QP order, (i.e., CYBERLINK is last. TELEX is second 
since the first byte is reserved, EI200 is third, etc.) 
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* 2 
Reserved 


TELEX 


E/I 200 


BATCH: I/O 


MAGNET 


TRANEX 


TELEX 
Stimulator 


TRANEX 
Stimulator 


RESERVED * d 


CYBER 
LINK 



SSCL 
SSCL+1 



* 1 If SS is not active then SS byte = 0, if active then 

byte = CP number. 

* 2 Inviolate byte 

* 3 Used for transient SS such as CMS (initialize MS) 

When all of the above is done correctly, the DSD type-in, MYJOB, will: 

1) Cause DSD to call IDS which will 

2) Find MYJOB in its table and build an FNT/FST entry with QP = MYPS of 
type INFT in the FNT tables. This effectively puts my job into the input 
queue . « 



U 



IE 



6 



FNT 



FST 



Controlling 
Routine 

1 M 


PP 
Y 


CP number Job Sequence 
Desired j Number 

75B | 

i 


Job 
Origin 
= SYOT 


"INFT" 


* 1 



1 


6 6 


12 


12 12 


12 




id 
= 


eq*2 
=0 


First 
track* 2 =0 


First 
sector* 2=0 


FL 
Required 


QP 

7765B 


i 




* 1 

* 2 


1SJ i 
Thes 


arill set CI 
e fields r 


3 assignment in 
sfer to job card 


lere 
strean 


i and s 


nc 


e 




1 



SS doesn't have one at this time they are zero. 



3) 



Eventually 1SJ will be initiated and, assuming no other SS jobs of higher QP are 
in the input queue, will pick MYJOB as the best job. 1SJ will trap this as 
an SS job in subroutine SFJ (search for job) since its QP is greater than 7763, 
and will jump to the subroutine SSS in overlay 3SA . SSS will read the FNT/ 
FST entry and the SS control words SSCL and SSCL+1 . If the SS byte is nonzero 
,-. _., — ~ «.^c«^,j. ^^uj.yC/ wuu wxix ^xecix Liie x' i\ x ctnc urop io*j . ii tne d^ oyte 
is zero (i.e., SS not active), SSS will request the control point specified from 
CPUMTR. If the control point is not specified, SSS will drop 1SJ. (This is 
illegal - a CP must be requested). If the control point requested is not 
available, then SSS will request rollout of the offending job and drop 1SJ. 
When iSJ is called again, it will find this SS, transfer to SSS, and find 
the control point available. SSS will assign this SS to the control point and 
stuff the control point number in the last byte of the FNT. Protective code 
prevents an SS from requesting a control point which is not defined in the system, 
such as or> last control point number. It will then build the CPA . STSW and 
JNMW are set: JCIW, TSCW and CTLW are set to the maximum; and APUW, 
ACUW and AACW are set to all 7s (i.e., maximum). It sets CSPW to all 
zeros, except EOR flag is set (i . e , no input file). It clears all the rest of 
the CPA. This effectively gives the control point unlimited access. It then 
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clears the 1SJ active flag, JSCL + 1, and requests 1SJ with monitor function 
RSJM. It -will put the requested start-up routine, 1MY, into its IR and exit 
to PPR (i.e., start-up 1MY in this PP) 1MY must reside in RPL or PLD. 

4) 1MY will set up the CPA whatever way it wants it. It then sets up a control 
card call to MYJOB, the controlling CPU routine, which must reside in the RCL 
or CLD (via SYSEDIT or from the dead-start tape). Then 1MY will exit to 

1AJ with the parameters set to specify where the control card(s) is located. 
1MY may either drop or stay depending on how the SS will use it or other PP 
routines. (It may also request required FL. ) 

5) 1A J will advance the job by loading the CPU overlay requested (MYJOB) ab- 
solute binary, and starting up the CPU. After the loader has loaded the 
routine, control will be passed to it. 

6) Now, MYJOB is in control and can run as an SS privileged control point. 
It is a good idea to have a control card stream with an EXIT card followed 
by a control card call to some recovery routine, in case the SS sets an error 
flag. Otherwise, the SS will be aborted on a fatal error. 

5.3.2 Special Entry Points (SEP) 

Many functions normally performed in a PPU can be done better in the CPU (such as 
DMP). However, a normal CPU program is too restricted to perform these functions; 
hence, the concept of SEP is provided. 

An SEP program runs in the CPU cind is able to: 

1) access privilege files (VALIDUX, PROFILO, etc.) 

2) access CM outside of its normal FL via (SIC and RSB requests. 
See para. 5.3.6 for the format of these calls). 

Anyone can code an SEP routine, but it must be SYSEDITED onto the system in order to 
work. A local file with any SEP processors would be treated as a normal entry point, 
however when they attempted to do a privileged SEP procedure, they would be aborted. 

The procedure for writing an SEP routine is as follows: 

1) CP code the routine using one of theSEPs defined later. 

2) Write the program in ABS format. 

(Only ABS type binaries may contain SEPs. ) 

3) SYSEDIT the job onto the system. 

4) Run the job by calling it via: 

a) A control card request, 

b) an X. SEP. console command (e.g., n.DMP, etc.), or 

c) an RA+1 request. 
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.nis metnoa omy worics in tne louowmg two ways: 

1) The RA + 1 request is for a processor that is in the SFP category or modified 

to be in the SFP category. (See overlay 2SG, SRP — Special Request Processor 
in SFP . ) 

2) The RA+1 request is for a user-supplied PP routine which will get the absolute 
deck from the system, set SPCVV, and call 1AJ to process a function 3 request 
(1AJ call from other PP routines). 

processes the SEP in the following manner: 

1) The binaries are loaded onto the system device (either during deadstart or 
appended onto the running system file) and a normal CLD entry is made. 

2) One extra word is appended onto the end of the CLD entry. Its format is: 

15 11111 18 13 

SEPA = 



A | 


B 


C 


d|e|f 





DA 


SA 



Where; 

A Set to indicate special entry point table entry. 

B Set if ARG = entry point present. 

C Set if DMP= entry point present. 
("DA" is associated parameter.) 

D Set if SDM= entry point present. 

E Set if SSJ= entry point present. 
("SA" is associated address.) 

F Set if VAL= entry point present. 
DA = VFD 2/0, 1/S, 1/C, 1/F, 1/U, 12/FL 

Where: S = Suppress DMP- on control card call. 

C = Only create DM* with nothing on it. 

F = Dump FNT entries, CPA and field length, to 
file DM* . 

TT = Preote fild mUT* oe an unlrioVor) filo 

FL = 0, for dump of full FL. 

FL, for dump of FL* 100B of FL. 

All normal ABS entry point names in the CLD will have bit A = 0. 

The following system functions are SEPs: 

1) CHECKPOINT/ RESTART 

2) DMP - dump field length 

3) SCOPE 3.4 PP requests 

4) RESEX — resource allocation 
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The following table summarizes these functions: 
Special Program Requests 



RA + 1 Request 


PP-Request 
Processor 


CP -Request 
Processor 


CKP 


SFP 


CHKPT 


DMP 


SFP 


CPMEM 


REQ 


SFP 


RE SEX 


LFM/PFM 


LFM/PFM 


RE SEX 



(SCOPE products checkpoint) 
(field length dump) 
(SCOPE request macro call) 
(tape / removable pack requests) 



The flow of an SEP request is: 

1) The RA+1 request must be made with auto-recall 

NOTE: Monitor will force auto-recall on all RA^l requests, except CIO, 
unless the job has QP greater than MXPS. 

2) SFP processes CKP, DMP and REQ because they are not present in the PP 
library directory and SFP is called for all requests not found there. 

3) Once the PP-request processor (SFP/LFM/PFM) decides it requires the 
service of a CP-request processor, the PP must set up the following, and 
then terminate — 

a) Set special processor call word in the control point area: 

18 1 1 1 1 2 12 6 18 



SPCW = 



Entry point name 



B 



D 



O 



12 

Status 1 
return 



O 



PBA 



Entry point = entry point name of CP processor to be called 

A = Special Program Request active (set only by 1A J) 

B = RA-1 to be cleared before program reload, if this bit 

is not set. 

C = Remainder of word is parameter list and not address of 

same. 



D 



= If set, do not start CPU back up (set only by 1A J on control 
card calls). 



Status return = Will be set by CP processor at completion. 
PBA = Parameter Block Address (must be within FL). 

The PP-request processor must check the upper 12 bits for zero and set 
SPCW only if it is clear. If not, it indicates SEP already at this CP. 

b) Set rollout flag in control point area (ROCM function). 
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c) If CP is to be restarted upon completion of CP-request processing, the 
PP-request processor must set any completion or status bits in CM before 
terminating. If a PP-request processor is to be recalled upon completion 
of CP-request processing, the PP-request processor must set the 'B' 
field of the SPCW word. 

d) All PP processors must write their input registers back to RA+1 (using 
'B 1 ' of SPCW to clear it if desired) in order to get it passed to the CP 
processor. 

4) Once the PP-request processor terminates, 1AJ will find the call word 
set (SPCW). 

a) The CP-request processor must: 

1) Contain an entry point for each possible call to it via the call word 
(e.g., RESEX has entry points, SFP, LFM, andPFM). 

2) Not activate another CP-request processor while, it is active. 

b) 1AJ calls 1RO to process the DMP= entry point, if one exists. 

c) 1AJ takes the address from the call word and retrieves a 20B word 
parameter block from that CM address (which can be a FET, parameter 
list, etc.). Only available if DMP = specified. 

d) The CP-request processor is then loaded. 

e) Once the CP program is loaded, the CM changes shown in Figure 5-12 are made. 
Note that SEPW = SEPA is set up at this time, p. 5-23. 

5) Once the CP-request processor completes its task 

a) It sets any status to be returned in RAt27B(SPPR) . 

This will then be set into the call word (SPCW 24/0, 12 /status return, 24/0 

b) It sets the event descriptor, if desired, via EESET macro in 
COMCMAC . This is done when the CP job must wait on some action to 
complete before continuing. The timed event queue will roll the job out and 
in every minute (any selected time) until the action has occurred. 

(Like an automatic periodic recall cycle). For example, RESEX will 

set the job in the timed event queue on a VSN command if the required tape 

is not mounted . 

c) It terminates normally. 

6) 1AJ will discover that a CP-request processor has completed and will call 
1RI to: 

a) Retrieve status and parameter block from CM (RA+27 - RA+47) 
PBA only available to DMP= type job. 

b) Reload control point area and field length from DM File, if DMP = exists 

c) Reset updated parameter block back into CM 
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RA 
RA+1 



(SPPR) RA+27 
RA+30 



8 



8 



RA+47 



8 



(PGNR) RA+64 



8 



— RA+1 stored here 
(IR of PP processor 
stored in RA+1 by the 
PP routine) 



— 20B word parameter 
block stored here 
(if program requires 
more than 20B words, 
it must read the BMP 
file, DM* for it) . 
Only available with DMP= 



— Cleared to indicate 
call was initiated 
by a PP-request 
processor (other - 
wise non-zero 
indicates normal 
control card initiation) . 



Figure 5-12. Field Length of Loaded CP-Request Processor 
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d) Update control point area (selective areas) 

1) Clear call word 

2) Set return status 

7) Then 1AJ will advance the job, which may merely restart it where it 
left off (in the case of the System DMP macro) . 

8) Any SEP can be rolled out while it is processing. 1AJ 1RO, 1RI will 
process this as any other job. DM* file and any other file FNTS plus 
the SEP jobs FL will go to a rollout file, and the job will be rolled 
out. Normal rollin will proceed when the SEP job is rolled back in. 

5.3.3 Special Entry Point Definitions 

The following special entry points are available in KRONOS 2.1 for ABS system programs. 
The routines SYSEDIT and 1AJ process these entry points. 

ARG= Suppress argument 

DMP= Dump previous job before load 

RFL = Automatic field length assignment 

MFL= Automatic minimum field length assignment 

SDM= Suppress control card dayfile message 

SSJ= Define job as special system job 

VAL = Define job as a validation processor 



Once a job containing these entry points has been loaded, 1A J will set up SEPW in the 
control point area, 

1 5 1 1 1 1 1 13 18 18 

SEPW= 



X 


o 


A 


B 


C 


D 


E 


O 


°DA 


°SA 



Where: 

X - SEP active flag 

A — ARG= present 

B - DMP= present 

C - SDM= present 

D - -SBJ= present 

E — VAL= present 

SA — SSJ= parameter block address 

DA - DMP= options 

NOTE: This is a copy of the SEP entry point word in the CLD. 
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1) ARG= 



Used for a job wishing to do its own control card argument processing. 
If present, arguments are not passed to RA+2, but the entire control card 
image, including statement label and other options ($, /), is placed in 
RA+70. 



2) DMP= 



A program using this entry point should set up the DA field in SEPW with a 
PP routine (in the case of the control card or macro DMP it is done 
automatically) as follows: 



1 1 1111 



DA = | R|0 |S|C |F jU| 



12 



FL 



Where: 

R 

S 

c 

F 

U 
FL 



— Restart Rollin 

— Suppress DMP= processor if control card call 

— Set, indicates create file DM* only 

— Set, indicates dump FNTs along with control point area 
and field length. (Complete File) 

— Set, indicates create file DM* in unlocked mode i.e. , write mode. 

— 0, dump entire field length 

jf 0, dump FL* 100 of field length (This is a 12-bit field 
and represents FL/100 desired) 



The DA field can also be set at assembly time by using the instruction 
EQU as follows: 

DMP= EQU XXYYYYB 

Where XX = bit configuration of BOSCFU 

and YYYY = field length specification 

The DM* file is the rollout file. The only difference is in the FNT. 
If it were a rollout file, then the FNT would be: 



jobname 


origin 
type 


tvpe 
ROFT 


CP = 
number 



However, as a DM* file the FNT would be; 



DM* 


origin 
type 


type 
LOFT 


This CP 
number 



and the file remains attached to this CP. 
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DM* is not a legal file name, and a CP user may never create a file -whose 
name contains special characters. However, a CP routine may read or write 
such a file if it already exists . Hence, 1RO must be asked to create the DM* 
file if an SEP job will need to use the file. See RESTART in Section 22 for 
an example of using an empty DM* file created by 1RO. 

The parameter list defined previously is only processed on DMP= SEP, and 
is actually moved to RA+SPPR+1 by 1RO. 

The flow of a DMP= request is: 

a) 1AJ will find this control point idle. 

"W" = "X" = "R" = or DIS will call 1AJ directly. 

b) LAJ calls 1RO, which creates a rollout file as specified in the DA field 
of SEPW. The file will be named DM* and left attached to the control 
point as a local file, 

c) 1AJ then loads the CP program specified in SPCW. 

d) DMP will dump the field length and CPA as requested in DA from the 
DM* file. When DMP is complete, the "W" = "X" = "R" status in the 
CPA will go clear. 

e) 1AJ will be called to advance the job; it will see that a DMP= has 

just completed and call 1RI to restore the control point FL and CPA from 
the DM* file, 

f) 1AJ will advance the job or restart the previous job. 

Figures 5-13 through 5-15 show a graphic picture of the procedure while 
Figures 5-16 through 5-22 illustrate the flow charts for this procedure. 



3) RFL= 



When a program with RFL= is loaded from the system, the program's field 
length is set to the value of RFL= (rounded to the next higher 100.). 

4) MFL= (Minimum FL) 

Same as RFL = except nothing is changed if the existing field length is greater 
than the MFL = value, (i.e., if present FL>' , MFL = ' r J then no FL change. 

a) sr>M= 



For programs with SDM= entry points, no dayfile message is generated on the 
control card call. The program should issue its own messages. Using ACCFAM 
as an example, the password on an ACCOUNT card should not appear in the 
dayfile. When ACCOUNT, ABCUSER, PASSWRD. is issued, ACCFAM using 
SDM ■ entry point can strip off the password and issue ACCOUNT, ABCUSER, . to 
the dayfile. 
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STEP 1 (Temporary Rollout) 



SYSTEM 



RA 



FL 



Control Point Area 



FNT/FST 



Job Field Length 




Figure 5-13. DMP= Processing (1AJ Calls 1RO) 
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STEP 2 (DMP= Job Load & Execution) 



SYSTEM 



RA 



Control Point Area 



FL 



FNT/FST 



Job Field Length 




DM* FILE 




Figure 5-14. (1AJ Call LDR to Load DMP= Program) 
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STEP 3 (Rollin DM* File) 



SYSTEM 



RA 



FL 



Control Point Area 



FNT/FST 



Job Field Length 




Figure 5-15. (1AJ Calls 1RI to Restore the Job) 



5-32 



97404700A 



DMP = JOB FLOW 

Job is either idle "W" = "X" = "R" status = 
or DIS has called 1AJ 




Search 
CLD 



Set up LDR 
to load 
CPMEM 



Load 
Routine 



Execute 

loaded 

v Routine, 



Figure 5-16. General Flow 
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DMP = JOB FLOW 

Job is either idle "W" = "X" = "R" status = 
or DIS has called 1AJ 



Previous job 
was not DMP= 



Process 
Control 

Card 



Crack control card 
DMP (X, Y) 




Search 
CLD 



This is not 
a DMP= job 
yet 

Find DMP 
as a 

part 

of 

CPMEM 



yes 




CPMEM hasj 
a DMP= entr ( y 
point 



L 



Figure 5-17. PASS 1 (Job Plow Has Come to a DMP Control Card) 
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DMP = JOB FLOW 

Job is either idle "W" = "X" = "R" status = 
or DIS has called 1AJ 



— ^ 



"\: 


tij p 


v yes 


vv. 1RO has not 

s^ \been called 
s 1RO x^no yet 






this a 


Call 


DMP = 




v Called y> > 


1RO 



Figure 5-18. PASS 2 



97404700A 



5-35 



DMP = JOB FLOW 

Job is either idle "W" = "X" = "R" status = 
or DIS has called 1AJ 





yes 

1RO was called 
last time 



Process 

Control 

Card 



TCS has a trap for DMP= already- 
found so he doesn't crack the 
control card again. 




We called 
1RO in the 
last pass 



Set up LDR 
to load 
CPMEM 



Load 
Routine 




Figure 5-19. PASS 3 
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DMP = JOB FLOW 



Job is either idle "W" = "X" = "R" status = 

or DIS has called 1AJ 

CPMEM has completed, job needs to advance to next 

control card *" 




yes 



no 



yes 

(tcsh- 



Process 

Control 

Card 



TCS uses DMP= last control card in preset and 
does not crack the new control card. 




Figure 5-20. PASS 4 
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DMP = JOB FLOW 

Job is either idle "W" = "X" = "R" status = 
or DIS has called 1AJ 





Process 

Control 

Card 



This time TCS will crack the new control 
card. Preset will know that 1R1 was called 
and we are now ready to get the new control 
card. 



Is 
this a 
DMP = 



yes 



s Has\ 

IRO/ IRIX, 
just com-/ 
spleted/^ 

l^ yes 


■^RI just 
complete 

no 


d 




DMP\ 


Search 
CLD 


Load routine 
which may not 
have a DMP= 


control y 
v card/^ 




entry point 


^v/yes 


1 






Load 
Routine 


/Execute 




\Routine, 



An SEA job cannot initiate another SEA job. 



Figure 5-21. PASS 5 
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6) SSJ= 



. VtJ- CtA-LA O VV J. Uti UUV ~ 
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address specified by the SSJ= entry point, determines the start of a parameter 
area where the user accounting control words from the control point area are 
temporarily stored to allow the special system job access beyond the user's 
validation. When the special system job completes (or aborts) the user's 
validation parameters are retrieved from the parameter area within the 
special system job's field length and restored to the control point area. All 
local files created by the special system job (ID=SSID=74)are returned before 
normal control card processing is resumed. Whenever an SSJ = job creates a 
file, the FST ID field is set to SSID <EQU 74 g ). In this way, 1AJ can ensure 
that any files attached to this control point during SSJ= processing will be 
released prior to returning control to the normal user. 

a) A COMSSSJ common deck is provided to supply the calling program with 
special system job parameter equivalences. 

b) An RFL= entry point must precede the SSJ= entry point to allow SYSEDIT 
to validate that the parameter area will fit within the special system jobs 
field length. If this condition is not satisfied, the SSJ= entry point will 
merely be added as another normal entry point for the program and no 
special processing will be done for it. 



ENTRY RFL 
ENTRY SSJ= 



\ This is the only 
J acceptable order. 



The first word of the parameter area (SPPS) is used to set the CPA values. 
If it is zero, the current values are retained. Limits for these values are: 

• <C CPU priority <C 70B 

• <C queue priority <C MXPS+1 

• < time limit < 77777B 

Any other values are ignored. Thus, it can be ensured that a task does 
not get a time limit error, that a task has a higher CPU priority than a 
normal job, etc. Values are reset when the task terminates. 



d) The SSJ= parameter block format is: 

24 



SPPS 



UIDS 



A PUS 



12 



12 





Time Limit 


CPU 
Priority 


Queue 
Priority 



42 


18 


User Number 


User Index 



12 


12 


12 


12 


12 


Maximum 


Maximum 


Maximum MS 


Maximum 


Maximum 


Mag Tapes 


Removable 


Tracks 


Local Files 


Deferred 


Allowed 


Packs 
Allowed 


Allowed 


Allowed 


Batch Jobs 
Allowed 
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SYSTEM COMMON DECKS 
SYSTEM JOB PARAMETERS. 



COMPASS 3.73130 



73/08/29. 11,57.30 



PAGE 



85 



CD 
-vl 

>Ji 
o 

-J 

o 

8 



MM 



74 


SSID 


EQU 


74 


75 


CBID 


EQU 


75 


7G 


CK1D 


EQU 


76 


77 


SOID 


EQU 


77 


70 


IDLM 


EQU 


70 



SSJL 



CTEXT COMSSSJ - SPECIAL SYSTEM JOB PARAMETERS. 

COMMENT COPYRIGHT CONTROL DATA CORP. 1973. 

COMSSSJ - SPECIAL SYSTEM JOB PARAMETERS. 
W.R. SACKETT. 73/01/27. 

BASE M 

FILES CREATED BY SPECIAL SYSTEM JOBS HAVE AN * DIS* ID 

ASSIGNED TO THEM. UPON SPECIAL SYSTEM JOB TERMINATION, 

ALL SUCH FILES ARE RETURNED. 

SPECIAL ID CODES USED BY THE SYSTEM. 



SPECIAL SYSTEM JOB ID 
CHECKPOINT FILE ID 
CHECKPOINT FILE ID 
SPECIAL OUTPUT ID 
USER LIMIT FOR ID CODES 



SPECIAL SYSTEM JOB PARAMETER AREA EQUIVALENCES. 

ACCESS PARAMETERS TRANSFERRED FROM USER, S CONTROL POINT 

ARE GIVEN THE FOLLOWING REFERENCES RELATIVE TO THE JOB, S RA . 

THESE VALUES ARE STORED IN CM FOR SYSTEM JOBS CONTAINING 
SSJ= ENTRY POINTS. THEY ARE STORED AT THE ADDRESS SPECIFIED 
BY THE ENTRY POINT AND ARE RESTORED TO THE CONTROL POINT 
AREA WHEN THE SPECIAL SYSTEM JOB TERMINATES. 

IF THE FIRST WORD OF THE PARAMETER AREA IS DEFINED TO BE 
NON-ZERO BY THE SPECIAL SYSTEM JOB, THESE VALUES WILL BE 
SET IN THE CONTROL POINT AREA - 
VFD 12/0, 24/ TIME LIMIT, 12/CPU PRIORITY, 12/QUEUE PRIORITY 



EQU 






SPPS 


EQU 





1 


UIDS 


EQU 


1 


2 


APUS 


EQU 


2 


3 


ACUS 


EQU 


3 


4 


AACS 


EQU 


4 



PARAMETER AREA LENGTH 

SPECIAL SYSTEM PARAMETER VALUES 
USER IDENTIFICATION (UIDW) 
ACCOUNT PERIPHERAL USAGE (APUW) 
ACCOUNT CENTRAL MEMORY USAGE (ACUW) 
ACCOUNT ACCESS CONTROL (AAW) 
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COMSSSJ 
COMSSSJ 


1 
3 


COMSSSJ 


5 


COMSSSJ 


6 


COMSSSJ 


8 


COMSSSJ 


9 


COMSSSJ 


10 


COMSSSJ 


1 1 


COMSSSJ 


12 


COMSSSJ 


13 


COMSSSJ 


14 


COMSSSJ 


15 


COMSSSJ 


16 


COMSSSJ 


17 


COMSSSJ 


18 


COMSSSJ 


19 


COMSSSJ 


20 


COMSSSJ 


21 


COMSSSJ 


22 


COMSSSJ 


23 


COMSSSJ 


24 


COMSSSJ 


25 


COMSSSJ 


26 


COMSSSJ 


27 


COMSSSJ 


28 


COMSSSJ 


29 


COMSSSJ 


30 


COMSSSJ 


31 


COMSSSJ 


32 


COMSSSJ 


33 


COMSSSJ 


34 


COMSSSJ 


35 


COMSSSJ 


36 


COMSSSJ 


37 


COMSSSJ 


38 


COMSSSJ 


39 


COMSSSJ 


40 


COMSSSJ 


41 


COMSSSJ 


42 


COMSSSJ 


43 


COMSSSJ 


44 


COMSSSJ 


45 



^ SUB- SYSTEM COMMON DECKS. COMPASS 3.73130 73/08/29.11.57.30 PAGE 85 

£ SYSTEM JOB PARAMETERS 

o 

§ ** TIMED/EVENT ROLLOUT EQUIVALENCES. 

* SYSTEM DEFAULT TIMES FOR EVENT ROLLOUTS. 

454 CRT EQU 5* 60D * ROLLOUT* MACRO DEFAULT TIME 

740 MRT EQU 10* 60D ft REQUEST* MACRO DEFAULT TIME 

360 ART EQU 4* 60D * ATTACH* MACRO DEFAULT TIME 

M M BASE * 

ENDX 



COMSSSJ 
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COMSSSJ 


47 


COMSSSJ 


48 


COMSSSJ 


49 


COMSSSJ 


50 


COMSSSJ 


51 


COMSSSJ 


52 


COMSSSJ 


■53 


COMSSSJ 


54 



24 



ACUS 



AACS 



12 

Maximum 
CPU Prior- 
ity Allowed 



12 

Maximum 
Time Limit 
Allowed 



12 

Maximum FL 
Allowed in 
100B Units 



60 



Account Access Control Word. (Each bit has special meaning) 



The entire SSJ= block will be swapped with the CPA values unless word is zero, if 
word is zero, then just store the users CPA in the 5 word block. In any case, when the 
SSJ= completes, the 5 word block will be restored into the users CPA, thus the 
SSJ= program can and does place any values he sets in this block into the CPA. 

In fact, that is the way that ACCFAM sets up the users Verification area in the CPA, and 
is the way that CHARGE canset the VAL= flag bit 17 in UIDW to off. Also, the swap 
allows the SSJ= program to specify UI = 377777B for accessing VALID UX.RESEXVF, etc. 
New for level 5: If the SSJ= user specifies SSJ= EQU 0, then the swap does not occur 
at all, and all files created by the SSJ= user will not get ID = 75B, so that the files 
remain for the caller, but the job will get SSJ= privileges, SIC, RSB, etc. The only use 
is for LINK, which can create binary files and other type files which the caller needs, 
such as LGO. 

7) VAL = 

When validation is enabled, the system will abort any job of non-system (SYOT) 
origin which attempts to load and execute as the' first control card, any routine 
which does not have a VAL = SEP . This is the method employed to check Validation . 
The first two or three cards of a job stream must be JOB, ACCOUNT, and CHARGE 
(if needed) . ACCOUNT causes the loading of ACCFAM , and CHARGE causes the 
loading of CHARGE, both of which contain VAL = SEPs. The system will allow these 
routines to run, and assuming that they don't abort the job, they will enter this job 
stream into the system. Once they are done, then the VAL= system checking is no 
longer done for this job. If a user did not have an ACCOUNT card as the second 
card {say COPY) it will force a load of a routine without VAL= SEP, and the job 
would be aborted by the system. 

8) Following is a chart of which programs are currently making use of the special 
entry points. 







MFL = 


ARG = 


RFL = 


DMP= 


SSJ= 


SDM = 


VAI 


a. 


CHKPT 






X 


X 


X 






b. 


RESTART 






X 


X 








c. 


RESEX 




X 


X 


X 


X 






d. 


CPMEM 


X 






X 


X 






e. 


CHARGE 




X 


X 




X 


X 


X 


f. 


ACCFAM 






X 




X 


X 


X 
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g. 


PROFILE 


h. 


MODVAL 


i. 


PFILES 


< 


PF Utilities 


k. 


BLANK 


1. 


SYSEDIT 


m. 


TRANSIM 



MFL_= ARG= RFL= OMP = SSJ = SDM= VAL = 

XX X 

X XX 

X X 

X X 

XX X 

X X 

X X 
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5,3.4 Special RA + 1 Requests. (TLX, SIC S RSB) 

The following three RA+1 requests can only be used by an SS or issued to an SS. Two of them 
(SIC - RSB) can also be used by SSJ= or QP>MXPS type jobs. 

One "TLX" is used to call special PP routines, the other two, SIC and RSB, are used for 
inter- control point communication. 



5.3.5 Special PP Calls 

A normal CP routine may only request PP routines whose name begins with a letter. This 
is a protective feature to keep normal jobs from accessing certain system PP routines. 
By convention, any PP routine which should be available to a user, and is coded is such a way 
as to keep from destroying the .system if called by an improper request, all have a letter 
as the first character of their name. Other dangerous PP's have a numeric as the first 
character of their names. 

Sometimes it is desirable for a CP routine to call a special PP, such as TELEX calling 
1TA. The TLX RA+1 request was designed for his purpose. 

TLX process special PPU request is: 

RA+1 = 

Where: 

1) Addr = address of a cell containing the name of the PP routine desired and its 
arguments . 

2) Auto recall is not honored 

3) If the addr word is cleared, the request was honored and the PP routine was 
started. 

4) If the addr word is unchanged when the CP regains control, the PP routine was 
not started (possible PP saturation, etc.). 

5) The call is only honored for jobs whose QP is greater than MXPS. 
All other jobs will be aborted. Actually, the call is passed to a PP which will 
abort the CP unless a PP exists named TLX. 



addr 



TLX 




addr 



PP routine 
Desired 





Arguments 



36 
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5.3.6 Inter Control Point Communication For SS 

The control point concept allows each control point to run independently of any other control 

points in the system. In addition each control point is protected from any other control 

point destroying any part of its CM FL. In some cases, however, it is necessary for one 

control point to communicate with another, as in TELEX, to TRANEX and RESEX to 

MAGNET.' 

An SS wishing to communicate with some other control point (maybe another SS) by sending 
information, can set up a communication block using ICAW in CPA and transfer it to a 
designated control point. Also, an SS may receive a block of data from some other control 
point (which may also be another SS) . 

The control of the transfer is based on the SS QP, and, therefore, must be unique. 
The buffers are defined in ICAW in CPA. The following two RA+1 requests are used 
for this communication. 

• SIC — Send inter-control point data block from a control point 
program to the specified SS. 

(RA+1) = 



SIC r 




buff 


St 



SIC 

r 

buff 

St 

(St) = 



Display code 

- 1 if auto recall is desired in bit 40 

- Address of the buffer to transfer to the subsystem 

- Address of status word for the transfer 



18 



12 



30 



bn sqp reply 



bn - Buffer number of subsystem to transfer to 

sqp - Destination subsystem queue priority 

reply - Not used 

A block starting at buff will be moved to the indicated subsystem. The block length is 
specified in bits-0 - 17 of the first word of the block (buff), which includes this header. 
The block length must be less than 101B (to force CPUMTR in MTR mode, this operation 
must be very fast. ). 

NOTE 
The request is honored only from jobs with: queue priority > MXPS (i. e., sub-system 
status), or an SSJ= entry point defined (see 1AJ Section 6), or with access bit (CSTP 
(user may access special transaction functions) turned on. 
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The request from any other job will be treated as a P? call. 
Response 

(ST) = 



18 



12 



30 



bn 


sqp 


reply 



bn and sqp unchanged 



iOfJijr 



3 If designation subsystem is not present in the system 

5* If subsystem buffer is full, subsystem being moved, or 
subsystem job is advancing 

7 If block length as specified in the first word is larger than that 
permitted by the subsystem. 

11 If destination buffer is undefined by the subsystem 

The format of the buffer block to transfer is: 

buff + 

+ 1 
+ 2 



+n-i 
+ n 








block length 
= n - 1 




1st data word 




2nd data word 




> 




n- 1st data word 




nth data word 



NOTE: n< 100B so entire block length is 10 IB. 



RSB — Send inter- control point block from SS to the calling control point, if 
no SS is specified, from absolute CM. The calling routine must have an SSJ = 
entry point defined (See special entry point. Section 5.2.2). 



The format for this call is: 

18 



12 



18 



Where: 

RSB 

r 
sqp 



St 



(RA+l) 



RSB 


H 


j sqp 


St 



Display code request 

1 if auto recall desired in bit 40 

Subsystem queue priority (or control point to read) , If it = , then 

block is read from core memory or relative to callers control point 

area . (see note on buffer below) . 

Address of status for the read s 



* If auto recall is specified , the control point will remain in recall until condition 5 ends . The 
subsystem may indicate whether its buffer is full by setting the first word in the buffer non- 
zero, i.e. , if the first word of the buffer in the SS is non-zero it can not receive info. , if 
it is zero, it is ready to receive data. 
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12 



12 



18 



18 



(St) = 






wc 


addr 


buff 



Where: 
WC 
addr 
buff 



Number of words to read 

Address to read from CM or buffer address relative to SS. 

Address of buffer to receive data in this CPs Fl. 



When sqp = 0, the contents of buff determines whether the read is from absolute 
CM or relative to the callers control pont area. 

If (BuffX 0, the read is from absolute CM and addr in the St word is the absolute address in 
CM to begin the read. 

If <Buff) >0. the read is relative to the callers control point area, and Buff contains a 
list of addresses located within the CPA which are to be read. The list ends at WC or a 
zero list entry. The contents of the CPA address read is stored in the buff location which 
contains that address . 

(Buff + 0) is mearly a flag denoting a read from absolute core or relative to CPA in the 
case whre sqp = 0. The calling program must have an SSJ= entry point. 



Response 

St = 



Reply 


WC 


addr 


buff 



WC, addr, buff are unchanged 

Reply. = 4000„ transfer completed successfully 

o 

2000„ subsystem not present 

o 

If sqp t 0, just fill buffer 

If sqp = 0, and (BUFF + 0X0, fill BUFF from absolute core as specified in 
addr field. 

If sqp = 0, and (BUFF + ) > (CPA read), then an example of this format follows: 



Buff 40 

+1 
+2 

+WC-2 
+WC-1 



+ 1 



STSW 



STSW-17B 



£ 



MS1W 



APJW 
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NOTE: Buff through Buff+WC-1 is WC words 

then (job status word) from CPA will be stored in Buff+1 
{2nd word of EPA) from CPA will be stored in Buff +2 
(1st msg Buffer area) from CPA will be stored in Buff +WC-2 
(Prog number area) from CPA will be stored in buff+WC-1 

NOTE 

Buff through Buff+WC-1 is WC words. It is not possible to get the first word of 
the EPA since the address would be relative to CPA and any word ends the list. 
It would be necessary to know the absolute address of the CPA to get the first 
word of the CPA . 

The above is an example and is not intended to imply that only the CPA areas shown 
can be read. 
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6.0 INTRODUCTION 

This section describes the detail job flow for 1SJ, 1AJ, 1CJ, 1RO and 1RI. 

6. 1 1SJ - JOB SCHEDULER 

1SJ scans the FNT/FST looking for files of type input (INFT) or type Rollout (ROFT). 
1SJ determines priorities for these entries via ISP. 1SJ builds nine tables which it uses 
to determine which of the jobs in the input or rollout queue based on priority are to be 
reassigned to a control point and restarted. 1SJ rolls out any jobs which have a lower 
priority than this best job. It attempts to start the best job. If all fails, and 1SJ cannot 
find a best job to start, or cannot get enough resources for this best job, then 1SJ gives 
up. 

The next time 1SJ is called, the best job may not be the same one picked the last time. 
A best job is only guaranteed a start up of the resources necessary are available at the 
time the job is being prepared. 

MTR, 1AJ, 1RO, 1RI, 1TA or 1CJ may call 1SJ with the monitor function RSJM. 

CPUMTR will check the Scheduler Active Flag (SAF) - JSCL-^1 in CMR. If the SAF is 
clear, CPUMTR will call 1SJ to a PP. If the SAF is set, CPUMTR will also set the 
Scheduler Requested Flag (SRF) (JSCL in CMR). 

When IS J completes a cycle, it will check the SRF. If it is clear, it will drop from the 
PP. If it is set, it will check the scheduler cycle (JSCL in CMR). If the cycle is less 
than some preset number, it will restart; otherwise, it will drop from the PP. 

1SJ works with the current system status. Whenever many jobs make changes, these . 
changes will affect 1SJ only while it is executing. The JSCL and JSCL+1 words ensure 
that only one 1SJ can run at any time in the system, and (with the cycle count) 1SJ will 
only run so many times before exiting. This ensures that the system is not constantly 
scheduling jobs in and out or assessing priorities too often and thereby wasting computer 
resources. 
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1) 



2) 



3) 



4) 



IS J TABLES 



TACP - Active control points 
Entry = 1 word 
Descending priority 
Terminated by entry 

1 



p 


R 





• CP 



P - Rollout in process 

R - Rollout requested (used only in CFL) (Commit FL) 

CP — Control point number 

TRST - Table of rollout status 

Entry = 1 word 

Indexed by control point number 



1 1 



10 



Pit 



P — Rollout in process 

R — Rollout requested (used only in CFL) 

TJFL - Job field length 

Entry = 1 word 

Indexed by control point number 



1 FL | 

FL — Field length assigned at control point 

TAFL - Available field length by control point 

Entry = 1 word 

Indexed by control point number 



1 



11 



FL 



A - Control point assigned to job 

FL — Field length available at control point 
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5) TJPR - Job priority 
Entry = 1 word ~/ 

Indexed by control point number 

12 
PR — Priority of job 

6) TJOT - Job origin type 
Entry = ft word 

Indexed by control point number 
Set only if job active 

12 



OT 



OT — Origin type of job 

7) TMFO - Table of total available field length for all jobs of an origin type 
Entry = 1 word 
Indexed by origin type 

12 



[ FL 



FL — Field length available 

8) TAFO - Table of assigned field length by origin type 
Entry = 1 word 
Indexed by origin type 

12 



FL 



FL - Field length assigned 

9) TMJO - Table of maximum field length per job by origin type 
Entry = 1 word 
Indexed by origin type 

12 

I FL ~ 1 

FL Maximum FL allowable for a iob 
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The call: 



18 



IS J - JOB SCHEDULER 



36 



1SJ | CT" 



programs called: 1AJ - Advance Job Status 
1RI - ROLLIN File 
ISP - EVALUATE Priorities 

A diagram of the 1SJ interaction follows : 

RSJM MTR FUNCTION 




MTR requests 1SJ because the 1SJ 
recall time has expired or a CPU 
time slice has elapsed. 



/" X Calls 1SJ after 
/ \ beginning a job 



via a 1SJ call. 



Calls 1SJ after 
requesting a F L 
increase for 
TELEX 



IRO calls 1SJ whenever it enters a control 
point in the rollout queue. 

1RI calls 1SJ whenever it brings a job to a 
control point. 



Figure 6-1. IS J Interaction 

A flowchart of the IS J main loop and ISP main loop are diagrammed in Figure 6-2 through 
6-4. 
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Set number 
of control 
points 



Read system 
status word 
SSTL 



Set status 
control 




1 disable /enable control 



Figure 6-2. 1SJ PRS - Normal Preset (Non-Subsystem Job) 
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M3CJ J 



PR S 



preset 




Read 1SJ 
interlock 

JSCL+1 read 
clock RTCL 



Read 1SJ 
control 
JSCL 



Yes 




Set IR=1SP 
IR+1, . . . IR+4 



[^ 




/scj\ 

P 



Clear 

requested 
bit 




Increment 
recycle 

count by 1 



Clear inter- 
lock word 
JSC L+ 1 



yes 




*4 



*4 



1SJ call ISP on top of itself, when ISP is done he will call 1SJ back to this PP. (This 

interchange is done without informing monitor. 

If maximum number if rollouts reached don't issue anymore. 

Whenever a routine calls 1SJ it uses the RSJM function CPUMTR will set the interlock 

bit SAF and call 1SJ, but if its already set CPUMTR will ignore the request telling the 

PP that 1SJ was called and CPUMTR sets the SRF. 

Drop the PP. 

Figure 6-3. 1SJ Main Program 
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Build 

TAFO 

table 



SCS 



Set avail- 
able central 
memory in 
ACML 



*1 



Set control 
point 

status 




Find job in Queue 



SJC 



set job 

control 

\ information / 




ves 



Load job 
priority 




ves " 




1 Take snap shot of control points and build RACP, TRST, TJFL, TAFL, TJPR and TJOT 
tables. These tables are used by IS J to make all scheduling decisions. 

'2 SFJ finds a job to schedule and determines if it is a subsystem job or regular job. 

: 3 Since requested flag cleared during last jump to SCJ this will end IS J. 

Figure 6-3. 1SJ Main Program (Continued) 
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Check memory requirements 
if central memory not available 
rollout jobs to reclaim memory 



Check control point assignments. 
If control point not available, 
rollout some other job. 




Read 1SJ 
control word 
JSCL 





* 1 If scheduled rollouts will clear up enough FL for job then 1SJ can go away and come bad 
later when the rollouts are complete. 

*2 Schedule rollouts until enough FL will become available. Use ROCM function for all 
control points whose priority is lower than the one we are trying to schedule. 

•'-3 This is a switch telling 1SJ whether he is trying to schedule a job to a control point or 
attempting to increase a running job FL. 

Figure 6-3. IS J Main Program (Continued) 
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- — 1— 

AJP 

Adjust job 
priorities 



ISP is called periodically by 1SJ to evaluate 
priorities of files in the INPUT and OUTPUT 
queues. The CM time slice parameters are 
checked for jobs at control points. 



If CM time slice has elapsed and this job 
is within the queue ageing range, set this 
job priority = lower bound priority. 



T 



Read system 
status flag 
SSTL 
and set 
ageing dis- 
abled in 
AFP 



ATI 



assign time 
. increments . 

\ , / 

T 

AFP 
adjust file 
. priorities 



*1 



Add 1 to current interval count in JBC 
Job Control area Priorities 



Adjust queue priorities of all files in 

INPUT or ROLLOUT queues whose priorities 

fall within the queue ageing priority range. 



CET 

check system^ 
event table 




System event table is checked for resources 
described in (TEFT) time/event table FST 
entries encountered in AFPs search. He 
updates the time a job has sat in this table. 



* 1 If ageing disabled, AFP will not advance priorities in the FST of the INPUT and 
ROLLOUT QUEUES. 



Figure 6-4. ISP Evaluate Priorities 
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SRT 



set recall 
time 



Set up the IS J control information JSCL 
in CMR. (Scheduler Cycle) 



CMS 



check- 
mass 
storage 



L 



T 



CDV 



/ check 
point 




See if time to activate Label Check routine. 
See if any RMS initialize requests pending. 



See if time to check point devices; if so, then 

copy MST information and 

TRT onto device (in case of system 

failure, devices can be recovered). CDV 

sets up a call to 1CK if devices are to 

be check. pointed. 



* 1 Call 1SJ into this PP to continue. If ISP found anything for 1SJ to do he will set the 
scheduler requested flag JSCL in CMR. 



Figure 6-4. ISP Evaluate Priorities (Continued) 
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6, 2 1AJ - ADVANCE JOB STATUS 

1A J is called to advance the status of an active job. This action may be caused by: 

1) The Job Scheduler (IS J) wants to start a new job just scheduled to a control 
point. 

2) Either monitor has sensed no activity at a control point ("W" and "X ! ' bits 
clear). 

3) "DIS" or other similar programs wish to process an error flag or a control 
statement. 

The general 1AJ call is as follows: 
• PPU Direct Cells 



IR 



Input Register (IR) 



1AJ or 



IR-rl 

1 



IR-2 
12 



IR-3 



IR-4 



TCS CP 



FN 



Parameter 



CP = Control point number 
FN = Function number 
P = Parameter 



The (TCS) Translate Control Statement can be called directly. 

• FN = 5 (For Control Card Read and Execute) 

_ 18 i l 5 : i 



TCS j 1 CP | 5 | A DDR 



ADDR = address from which to read control statement 
All other 1AJ calls are defined below: 



IR 



( IR+1 



; IR+2 



IR+3 



FN = (From MONITOR, 1RO, and DIS for SSJ = and DMP = 
18 : j.._ 5 _12. : 12' ; 



IR = 



1AJ 



I i CP 











N - 1, set by 1KO upon completion of DMP= processing 
N = 2, set by DIS for SSJ= and DMP= processing 

FN=1 (From 1SJ) 



IR = 



FA = address of input file 



IR+4 



JJL 



18 : 


1 


5 


12 


: 12 


12 


1AJ | 





CP 


1 


I o 


FA 
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FN = 2 (From DIS) 

IR = 
DC = 





i 5 : 12 ; 12 : 12 


1AJ 


cp 2 | T dc 



Bit 2 set, indicates take control statement from MS1W 

Bit 1 set, indicates return error message to MS2W with no error flag 
on invalid control card. 

Bit set, indicates read statement and stop prior to execute (RSS 
indicator) 



FN = 3 (From other PP programs) 
: 18 1 1 5 



12 



12 



IR 



1AJ 



CP 



12 



FN =4 (For control card fetch) 



IR= 



; 18 ' 1 5 ; 12 


6 ' 18 ; 


1 1AJ | CP | 4 


SF A DDR 



SF = Subfunction number for reading control statement 

= Advance pointers 

= 1 Read only if not a local file load 

Do not advance pointers 

= 2 Set bit 17 in argument count if local file load 

= 4X If parameters to be cracked in SCOPE format 

ADDR= Address to READ/WRITE control statement FROM/TO 

The dayfile message is " SPCWCALL ERROR". This signifies that a DMP= type call was 
made, and the program called is either not in the CLD or does not have a DMP= entry 
point defined. 

The programs called by 1AJ are: 

1CJ — Complete job 

1RI — DMP= rollin 

1RO — Rollout job, normal rollout and DMP= rollout 

CIO — Complete special files on errors 

DMP — Exchange package dump (for certain error flags) 

RPV — Process reprieve errors (SCOPE function) 
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The common direct location assignments are: 



'NjgrYiD 



Value 






AB 


20-24 


CN 


25-31 


FS 


32-36 


EP 


37 


SP 


40-44 


OT 


45 


EF 


46 


RO 


47 


FA 


57 


CW 


60-64 


RF 


65 



Assembly buffer 
CM word buffer 
FST entry- 
Entry point pointer 
Statement pointer 
Job origin type 
Error flag 
Rollout flag 
Address of FST entry 
Library control word 
Reprieve error flag 

In general, 1AJ is called by MTR, 1SJ, or DIS. However, in the case of Special Entry 
Points (SEP) 1RO will call 1AJ back after rolling a job out to DM* and setting up a control 
point for the Special Entry routine. An SEP can be rolled out, and when it is rolled back 
in, 1RI will call 1AJ to advance it. 

1AJ, 1SJ, MTR, 1RI and 1RO interaction are illustrated in Figure 6-5. 

1AJ uses the following overlays: 

1) 3AA — Begin job 

2) 3AB — Process error 

3) TCS — Translate control statement 

4) LDR — Absolute CPU overlay loader 

5) 3AC — Search peripheral library 

6) SAD — Search for overlay 

7) 3AE — Load copy routines 

8) 3AF — Special entry point processor 



A description of each overlay and their flowcharts follow in Figures 6-6 and 6-7. 
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If a special entry point 
is encountered, then 1RI 
and 1RO calls 1AJ. 



If an "input" file, 
1SJ calls 1AJ, if a 
rollout file, 1SJ 
calls 1RI. 



MTR calls 1AJ 
to a ctl. pt. with 
no activity (i. e. , 
C. P. in zero 
status ) 




Rollin Job 



If rollout flag 
is set, 1AJ calls 
1RO. 



Rollout Job 



Complete Job 



If EOR on Input file i. e. , 
no more activity for this 
job or abnormal termina- 
tion. 

Also if origin code greater 
than four. 



Figure 6-5. 1AJ Interaction 
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9 74 04 70 OA 



Job Advancement 



0000 





PP 

Resident 


1100 




1332 


1AJ 

Main 

Program 


1356 






1AJ — Preset 
Routines 




3AA — Begin Job 




3AB — Process 

Error Flag 


5055 






3AE — Load Copy 
Routines 


5226 


3AF - Special 

Entry Point 
Processor 




0DF— Drop Files 


7000 









Translate Control 
Statement 



Absolute CP Overlay 
Loader 



TCS 

Main 
Program 



TCF - Preset Routine 
3AC - Search Periph- 
eral Library 
3AE - Load Copy 
Routine 

3AF - Special Entry 
Point Processor 



0DF - Drop Files 



LDR 




Main 




Program 


3AD - 


Search for 




Overlay 


3AE - 


Load Copy 




Routines 



7777 



Figure 8-6. lAJ Major Overlay Core Layout 
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flNTj- 




Read Control 
Point Status 



CM = STSW 
CN = JNMW 
AB = JCIW 
FS = RLPW 
Tl = EECW 
SP = CSPW 



RO = Rollout 
flag from 
AB+2 



EF = Error 
Flag from 

CM+1 



STSW 



*1 



JNMW 



JCIW 



RLPW 



EECW 




RF = 



/int" 


\ 1 


yes 


) 

< 


< 




RF = Error 
Exit from 
Tl+1 




CSPW 



CP area cells used 

12 12 12 



Error 

Flags 







RA/100 

FL/100 



Number of PPs assigned 

1 Bit 53 job advancement flag 

—Bit 56 set if sub-CPs active 
Bit 57"R" auto recall bit 
'—Bit 58 "X" status (recall) 
-Bit 59 "W" status (CPU wait) 



42 



Job Name 



12 



Job origin code 

Operator assigned eq. 




Bit 27 Rollout in progress 



•Bits 33, 34, 35 CPU status for. 
rollout. 



PP Recall Register 



3 3 



30 



18 



Terminal 
Input Buffer 



Error 
Exit 



Bit 47 set, if error flag 
instead of option. Bit 18 set, 
if 0-17 is reprieve error 
return address (SCOPE function) 



12 1 



23 



12 



12 



FST 




Control 


Next 


Limit 


addrs 




Statement 


stmt 


index 


INPUT 




Count 


index 





L 



Bit 47 set, eor on control 
statement (control card) 
file. 



1 Read 1 CM word into 5 PP words 

Figure 6-7. 1AJ — Advance Job 
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FS="X" and 
"W" status 
from CM+0 



OT = origin 
type from 
CN+3 




FN Function # 



Table of Processors 
Functions 



Monitor call 
IS J call 
DIS call 
other PP call 
control card fetch 



Name 



CSR 
SCH 
CSR 
OPP 



< 1 is FN function from IR+25 5 

-2 protective code. If an origin code > 4 is not trapped the processors will malfunction 
and the system could crash. 



Figure 6-7. 1AJ - Advance Job (Continued) 
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Rollout Terminal Job 



Set IR+4 = 

EF 

(A) = 1RO 




*2 




IR&IR+1 = (A) 
Call this routine 
into this PP 



IpprI 

* 1 Since it is not TELEX origin and no advancement is possible terminate the job. 

* 2 Ensure empty control card buffer by indicating eor. 
*3 Is queue priority of job at CP1 = 7775B 



Figure 6-7. 1AJ - Advance Job (Continued) 
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Process Monitor Call 
Function = 




SEPW 



CM = SEPW 
CN = SPCW 




SPCW 



CP Area Cells Used 



1 5 



13 



11 



re- 
serve 



DMP= par 
value 



18 



SSJ= par : 
block j 
addrs I 



Bit 59 set indicate presence of 

entry points 

Bits 58-54 reserved 

Bit 53 "ARG = "entry point present 

Bit 52 "DMP=" 

Bit 51 "SDM = " 

Bit 50 "SSJ=" 

Bit49"VAL=" 

* par is parameter 



18 1 5 



12 



18 



CP prog 
entry pt 
name 





Status 
Return 





par 

block 

address 



Special processor 
request active 

(Simplified-questionable code) 



*1 
*2 
*3 
*4 
*5 
*6 



Read 1 CM word into 5 PP words 

Is CN=CP entry point name ^ 

Is RO+FS rollout flag +"W"+"X" status 

Is RF or EF not = zero 

See description of overlay 3AF 

May not match code exactly 



restore CP 

fields 
. /3AF/RCF. 

\ : / 




Figure 6-7. 1AJ - Advance Job (Continued) 
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SSJ= or DMP= call 
f / CSB> 




no 



FTN 



drop CPU 

from this 

CP DCPM 



EXR 



translate 

control 

card TCS 





Get CP prog 


entry point 


name into AB 


AB=CN, AB+1 = 


CM+1 


' ' 




/LDR/CLD\ 

Search 
for routine / 
in AB / 




1 This path will force job to be rolled out and 1AJ will drop. 

■2 3AF exits via a call to 1RO and drops from PP. 

= 3 CLD is a routine which is loaded wherever *CALL COMPCLD is. 
CLD searches the Central Library directory for the entry in AB. 
(A)= address of Library Control word or =0 if not found. 



On exit: 



Figure 6-7. 1AJ — Advance Job (Continued) 
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SSJ= or DMP= call (cont'd) 




DFM 



"SPCW call 

error" 




Nc 



Clear 
SPCW 



Clear 
RA+1 



Clear 
rollout 

flag 

RO 



Set error 

flag 
EF=SYET 




*1 



; 1 System abort error 
2 1AJ will droD and this CP will be aborted- 



Figure 6-7. 1AJ — Advance Job (Continued) 
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Process scheduler call (function = 1) 




DIS ] Process DIS t and other PP calls (function = 2 or a) 




Begin Job 
3AA 



EXR 



yes 



error 
processor 
3AB 




Clear 
error 
message 




Store 
message 
into MS2W 




* 1 Exit to 1CJ if error flag set 

* 2 Turn off any special processor commands 

* 3 Read next control card and advance the job. If illegal control card then abort. 



Figure 6-7. 1AJ - Advance Job (Continued) 
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•nuvaace iuu 




Read PP 
recall reg 
CM=RLPW 




1 Rollout file 



Figure 6-7. 1AJ - Advance Job (Continued) 
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Advance job (cont'd) 




Processors 




Type 


Processor 


SYOT 


AJSX 


BCOT 


AJSX 


EIOT 


AJSX 


TXOT 


RTJ 


MTOT 


RTJ 



Drop PP 




FTN 



clear job 
advance 
flag JACM 




iPPR 



: 1 Is this the end of the control cards, then terminate 
2 Call TCS to process this card 



Figure 6-7. 1AJ - Advance Job (Continued) 
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6. 2. 1 3AA — Begin Job 

3AA initiates job processing at the control point. 

The only dayfile message is-. 
JOB CARD ERROR 

The direct location assignments are: 



Name 



Value 



pp 


60 


TN 


61 


PA 


62 


TT 


64 


TA 





Description 

Pot pointer 

Terminal number 

Pot address (2 words) 

Terminal Table address (2 words) 

TELEX reference address 



6. 2. 2 3AB — Process Error Flag 

3AB processes error flags by sending an error message to the dayfile. In the case of an 
arithmetic error, a call is made to DMP to dump the exchange package area. 

When these operations are complete, the control statement buffer is searched for the 
control statement EXIT. If this statement is found, 3AB returns to 1AJ to continue 
statement processing. If an EXIT is not found, control returns to 1AJ to complete the 
job processing. 

The dayfile messages are: 

1) "TIME LIMIT. " = The monitor has detected that the time limit for the job 
has expired. 

"ARITH, ERROR x AT yyyyyy. " = The monitor has detected an arithmetic 
error condition x at address yyyyyy. 

"PP CALL ERROR. " = The monitor has detected an error in a CPU request 
for PP action. 

"OPERATOR DROP. " = The operator has dropped the job. 

"PROGRAM STOP AT xxxxxx. " = The monitor detected a program stop 
instruction at address xxxxxx. 
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Get FST 
address of 
input file 
from IR+4 



T 



Processor Table 
Begin Job Processors 



Read input 
file FNT/FST 
entries 



T 



SYOT 


BBC 


BCOT 


BBC 


EIOT 


BBC 


MTOT 


BMT 



Save 

queue 

priority 



Clear CP 


area 


TSCW+1 


thru CSBW 




yes 



/ RJM \ 


F 








/ proper > 
\ processor / 




+ 




Store control 
statement 
pointer 
CSPW 




+ 




Store 
control card 

FST entry 


Set time 
limit 






-*- 


BJB 1 

4 J 




igure 6-8. 3AA - 


- Begin Job 
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Store job 
sequence 
number 
RFCW 



X 



Set EXIT' 
mode initial 
FLFLCW-3 
in EPA 



Set default 
family name 
PFNL arid store 
into PFCW of 
this CP ' ' 

I 



*1 Some routines do their own dayfile 
processing such as PFM 

*2 determine if 

1) Validation/Account enabled 

2) Job is not SYOT/MTOT origin 

If 1) is disabled or 2) is SYOT then ignore 
setting VAL=flag 

If 1) is enabled and 2) job is BCOT/EJOT 
then set VAL=flag bit 17 in UIDW in 
CPA to indicate validation is required 
by a VAL=type routine 



59 



18 17 16 00 



UIDW 



Preset 
account 
checking 
info. 



T 



user number 


VAL=flag 


UI 



UI can be from 1 + 377777B or max 17 bits 
so top bit i.e. bit 17 is available as a 
flag. 



Set up 
VALIDATION 
parameters 




Figure 6-8. 3AA — Begin Job (Continued) 
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FNT 
FST 



Change job 
name to 
INPUT 



INPUT 


Job 
origin 


INFT 


CP 

number 


ID 


EST 


1st 
track 


Current 
TRK sector 


queue 

priority 



Read job cards and position INPUT to eor 



RJC 



Read job 
card 

* 



Set track 
& sector 

in FST 



T 



Set exit 
mode = 7 



*1 



Return 



* 1 In exchange package 



Figure 6-9. SAA — Begin Batch Job 
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Set TELEX 
RA and SORT 
terminal 
number 



STA 



get input POT 
POINTER 
WORD 



ECS 



enter 

control 

statement 

} 



ETF 



enter 

\ terminal 
files-*FNT 

Releasee Pots 



Clear POT 
pointer in 
terminal 
table 



±. 



FNT 



Drop pots 
TSEM 



S et JOB f parame te r s 



Time Limit 

= 40 priority* 

value 

exit mode =7 



Return 



* 1 Read job card from TELEX pot and sets up control statement 



Figure 6-10. 3AA — Begin Multi-Terminal Job 
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Table of error processors 



Set EF = 
SYET 
Abort job 



SYOT 


EBC 


BCOT 


EBC 


EIOT 


EBC 


TXOT 


EBC 


MTOT 


EBC 



FTN 



clear 
error flag 
CEFM 



T 



Restore 

sense 

switches 




Return 



J 



* 1 is EF MXET max. error size 



Figure 6-11. 3AB — Process Error Flag 
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Table of Processors 



TLET TLI Time limit 

ARET ARI Arith. error 

PCET MCL Monitor call error 

PSET PST Program stop 



* 1 Look for exit card 



Figure 6-11. 3AB — Process Error Flag (Continued) 
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Process Arithmetic Error 




Read (RA) 



Send dayfile message for error 
mode and address. 
EXIT to DMP 



Convert 
mode and 
address — 
display code 



DFM 



issue 
error 

message 



mode 
y 

"ARITH. ERROR - AT 



(DMR 
Program Stop Processor 




Read 
XCHG area 



Convert 
address 



address 



DFM \ "PROGRAM STOP AT 



address 




Figure 6-11. 3AB — Process Err->r Flag (Continued) 
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Monitor Call Processor 




Read 



-1) 



Replace zeros 
with spaces 



Convert 

data 



DFM 



issue 
(RA+D - 
dayfile 



c 



Return 



3 



Time Limit Error 

© 



± 



* 1 



Increase 
time limit 
by 10 sees. 



c 



Return 



J 



* 1 Let user finish error processing if possible 



Figure 6-11. 3AB - Process Error Flag (continued) 
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6. 2. 3 TCS - Translate Control Statement 

TCS translates control statement in the following manner. 

1 ) Read the next statement from: 

a) The control card buffer in the control point area. If necessary, the 
• buffer is reloaded from the "INPUT" file. 

b) The message buffer for "DIS" type programs. 

c) A CM location for an executing program. 

2) Programs loaded from the system have their parameters cracked with KRONOS 
separator equivalences (unless a *SC SYSEDIT directive was used when entering 
the program into the system). 

Local file program loads have their parameters cracked with SCOPE separator 
equivalences (unless a "/" prefix character exists on the control card). 

a) KRONOS parameter cracking — 

Delete all spaces imbedded within the statement, up to the character 
". " or ")". Any character not in the standard FORTRAN set (i. e. , > •£ ; 
ETC. ) are not allowed within the statement. However, they may be used 
in the comment. 

NOTE: A separator character is one of the set +-/ = , ($ 

b) SCOPE parameter cracking — 

Spaces are treated as separators. All special characters are translated 
to a 4-bit code. 

3) Search the list of special control statement names for a match with the statement 
being processed. (CTIME OR RTIME) 

4) Extract the first 7 or less characters from the statement up to a separator 
character and search the file name table for a file assigned to this job with 
this name. If a find is made, the field length will be restored if it is different 
from the amount set by the last RFL control card, or by the last call to CPM 
to set running field length. If such a file is found which is on a mass storage 
device, and it is in absolute code format, the file is read to central memory 
as a CPU program. If the file does not reside on mass storage, the job is 
aborted. If the file is in relocatable code format, control is transferred to 
the relocatable loader. The arguments for the program call are extracted 
from the control statement and stored in the argument region of central 
memory, RA+2 - RA+63B. The CPU is requested to begin execution of the 
program. 

5) Search the central library for a program with the name on the control state- 
ment. If such a program is found and the program contains an RFL= entry 
point, the field length will be set accordingly. Otherwise, it will be set as in 
4 above. Then, the requested program will be loaded and execution will 
begin with the arguments stored as in 4 above. 
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alpha, it searches the PP library for a program of this name. If found, it 
places this name with up to two octal arguments as a PP program request and 
exists to the program. No change will be made in the job field length 

PP program calls via control card are only valid from system origin, or if the 
caller has system origin privileges and the system is in debug- mode. 

7) If none of the above are done, the control statement is declared illegal and the 
job is aborted. 

The dayfile messages are: 

1) "ILLEGAL CONTROL CARD." = The control statement could not be identified 

by TCS. 

2) " TOO MANY ARGUMENTS." = The number of arguments on the control 

statement exceeds that allowed by the program. 

3) "FORMAT ERROR ON CONTROL CARD." - An error has been detected 

in the format of the control statement. 

4) " PROGRAM FILE EMPTY." = A load of an empty data file was attempted. 

5) " COMPILER NOT IN LIBRARY." = An LDC control card requested loading 

of a compiler not on the system. 

6) "LOADER MISSING." = Either CALL or LDR = were not found in the library. 

7) "IMPROPER VALIDATION." = A validation program {containing a VAL = 

entry point - account or charge) is required before continuing. 

8) "ADDRESS ERROR." = CM address in call is beyond the FL. 

The operator message available is: 

"WAITING FOR STORAGE. " = Job processing is waiting for memory to be made 
available . 

The routines used are: 

OBF - Begin file 

ODF - Drop special ID files 

The direct location assignments are: 

name value description 

Program format 
Character address 
Keyword start address 

TCS will process the two control cards CTIME and RTIME directly in subroutine SSF - 
Search for Special Format. TCS gets the CPU time for CTIME or the current time for 
RTIME and issues the time with the appropriate message to the callers dayfile. Then 
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PF 


65 


CA 


66 


KA 


67 



rrcsj 



INT 



Initialize 
, Direct 
i Cells 




LJM 



ves/ RCA 
> / Read control 

\ statement to 

\ addrs 



Read 
Next 
Statement 




Write 
statement 
to CP 

buffer MS1W 



UPS 



Unpack 
Statement 





* 1 If buffer empty and no eor RNC will read next buffer 

* 2 Store statement pointers 
*3 Process error and exit. 



Figure 6-12. TCS - Translate Control Statement 
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Main Loop (continued) 
/ XY 




* 1 If prog in local FNT files 1AJ tells LDR to load "LDR=" (relocatable loader) puts 

CP in "W" status with P = "LDR = " entry points and drops from PP. 

* 2 Will exit to ILLEGAL CONTROL CARD if name not found. If name is found it will 

iuau anu ^ ac iwU lc - 

* 3 Return with CP in "W" status. Check for $LDC call from TELEX and load compiler. 



Figure 6-12. TCS = Translate Control Statement (Continued) 
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IMT - Initialize Direct Cells 

'INT 





CM= STSW 
CN= JNMW 
AB= JCIW 
SP = CSPW 
CW= SEPW 



H 



RQSB = 

Queue 

priority- 



Clear PF, 
FA. EF, EP 



no 




Add 1 to 
ARGC 



* 1 Exit let error processor catch it 



Figure 6-12. TCS = Translate Control Statement (Continued) 
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INT - Initialize Direct Ceils (cont'd) 




Reset IR to 
entry pt 
name from 
SPCW 



c 



Return 



D 



Read 

CN=AB=SPCTt 




* i Will restore the former job from an SSJ=, DMP=, if necessary- 



Figure 6-12. TCS - Translate Control Statement (Continued) 
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Issue Statement to DayfUe 



Store clt. 

stmt, ptr 

CSPW 



T 



/ FTN 
' JACM 




Set Error 
flag = PP 
abort 



FTN 



CEFM 



yes 



FTN 



Clear job 

advancement 

JACM 




Store ctL. 

stmt, ptr 

CSPW 



— } — 

(pPRj 



T 



53 



Figure 6-12. TCS - Translate Control Statement (continued) 
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LDR 


R 


i 


: addr 



TCS is ready to advance to the card following CTIME or RTIME, All other control cards 
will force some routine to be loaded or an abort. 

6.2.4 LDR - Overlay Loader 

LDR will load absolute overlays in response to CPU program requests. 1AJ can request 
LDR by return jump to /LDR/CLD which is loaded by * CALL COMPCLD. CLD searches 
the central library, and, if an entry is found, LDR is called. 1AJ uses this technique for 
other type calls such as /LDR/LCP load central program. 1AJ effectively uses whatever 

pieces of LDR it needs to get routines loaded. 

LDR calls from the CPU routine are: 

] 18 1 18 

RA + 1 

Where: 

R - Auto recall if desired 
Addr - Address of request 



NOTE 

See Section 12 for a detailed description 
of LDR. 



6.2.5 3AC - Search Peripheral Library 

3AC searches for the program name in the peripheral library. If the entry is found, it 
puts the name in its IR and exits to PPR. 

The main routine it uses is SPL. The SPL entry is (AB-AB+4)=assembled name, and it 
exists if it is not found or if it is called to the program. SPL uses IT, CA, and AB-AB+4, 
and calls AOD and SLT. 
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6.2.6 3AD - Search For Overlay 

3AD performs an end around search of the overlay file for an overlay of the requested 
level . 

Its dayfile messages are: 

1) "OVERLAY FILE NOT FOUND" = Requested file is not available. 

2) "OVERLAY FILE EMPTY." = No data appears in requested file. 

3) " OVERLAY NOT FOUND." = Requested overlay is not on file. 

4) "ILLEGAL ACCESS TO EXECUTE ONLY FILE." File is execute only. 

5) " FILE NOT ON MASS STORAGE." 

6) "ENTRY POINT NOT FOUND." = Requested entry point is not on file. 

6.2.7 3AE - Load Copy Routines 

3AE contains subroutines used to load programs. 

Its dayfile messages are: 

1) "OVERLAY NOT FOUND. " = Requested overlay was not found. 

2) " FL TOO SHORT FOR PROGRAM. " 

3) "ILLEGAL LOAD ADDRESS." = Load address. LT. 2 

4) " UNIDENTIFIED PROGRAM FORMAT." = The file requested to be loaded 
was not in a recognized format. 

5) "ECS LOAD ERROR." = Bad load address from ECS. 

6.2.8 3AF - Special Entry Point Processing 

3AF contains subroutines for processing DMP= and SSJ= entry points . 

A description of the subroutines is as follows: 

1) RCF - Restore control point area fields. 

Entry - If no job activity 

Exit - Control point area fields restored. Files with special ID 
set are dropped. 

Calls - ODF, SPR 

2) IDP - Initialize DMP= program load on RA + 1 call 

Entry - If DMP= CP program to be loaded 
Exit - To program loaded 
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3) PSR - Process special processor request 

Entry - (A) = directory address from CLD 
Exit - to iRO for DMP= rollout 

4) RFJ - Reset former job 

Entry - If DMP= job to be restarted 
Exit - to 1RI for DMP= rollin 

5) SDP - Start up DMP= job 

Entry - Upon return from IRO at DMP= rollout completion 
Exit - None drop PP 

6) SPR - Set priorities 

Entry - (RCFA - RCFA +4) SSJ= priority values 

Exit - priorities in control point are set according to (RCFA -RCFA +4) . 
If (RCFA-RCFA+4) are all zero, no action will occur. 

7) TCA - Transfer control point area fields (SSJ=) 

Entry - (CSED-CSED+4) Special entry point word 
Exit - None, drop PP 

6.3. 1CJ - COMPLETE JOB (FINISH UP JOB AND CLEAR CP) 

1CJ performs all of the job termination procedures. 

These include: 

1) Release storage 

2) Release assigned equipment 

3) Release any common files used by job 

4) Dropping of any scratch files used by job 

5) Release all output files to output queue 

6) Place the accumulated CPU time in the dayfile 

7) Append the control point dayfile to the end of the print file, and flush dayfile buffer 

8) Updates Resource Files 

The 1CJ call is: 



1CJ 





CP 


• i 



(_P = control point number 
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The 1CJ dayfile messages are: 

1) "CP xxxxxx.xx SEC." = Accumulated CPU time for the job 
2) 



3) 

4) 



"CM xxxxxx.xxx KWH." = Central memory usage expressed as kilo-word- 
hours. (Field length X time) 

" MS xxxxxx.xxx KPR. 1 * = Mass storage usage expressed as kilo-physical 
records transferred. 



* MT xxxxxx. xxx KPR. 
records transferred. 



Magnetic tape usage expressed as kilo physical 



1CJ uses the following routines: 

OBF - Begin file 
ODF - Drop file 
ORF - Update resource files 

6.4 1RO JOB ROLLOUT ROUTINE 

1RO performs job rollout in response to a calling program (such as the job scheduler 
or the system display) or a dump field length function from 1AJ. 

The 1RO call is: 



IR = 



18 


1 


5 


12 


6 






18 




1RO 





CP 


FN 





N 







c 


F JU 


FL 



Where: 



CP = 
FN = 



Control point number 

Rollout 

1 Selective rollout to file DM* according to DMP= parameter 
Error flag for TXOT job (function 20) 

DMP= parameter (function 1). 
Bit 14 C - Create DM* file only. 
Bit 13 F = Dump FNT entries to file DM* . 
Bit 12 U = Create DM* as an unlocked file. 
Bit 0-11 FL = 0, dump CP area and entrie FL. 
i 0, dump CP area and FL* 100B. 
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Read Job 
name JNMJ 
and job control 
JCIW 



Read dayfile 
pointer in 
CMR DFPP 
and set status 

addraaa in DA 

RST 

Release 
Storage 



RLF 



Release 
Files 



REQ 



Release 
Equipment 



IE 



URF 



Update 

Resource 

Files 

f 




Release all memory for this control point. 
RST issues RSTM request zero words of 
memory. 

Close and clear all FNT/FST and drop all 
unused tracks for this control point (file 
OUTPUT will be checked later and if it 
exits then taken care of in RPF)* 2 . 

Release all equipment assigned to this control 
point . 

Use ORF clear all entries in RESEXDF for 
this control point. 



* 1 Used at CPJ1 

* 2 See next page 



Figure 6-13. 1CJ - Complete Job 
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Record CPU and PPU, CM, MS, and mag 
tape usages and issue dayfile messages. 



Set print file name to job name, set type 
to "PRFT" or "PHFT" (Sect. 2) append day- 
file to end of file and release file from this 
control point. 



Drop tracks 



Set job advancement control and request 
monitor to set this control point clear . 



* 1 Is there a file whose name is OUTPUT? 

* 2 Use cell DA set on last page 

* 3 JACM will drop the PP when op code =2 or 3 in OR. 

Figure 6-13. 1CJ - Complete Job (continued) 
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1RO uses the OBF, begin file, routine. Its direct location assignments are: 



Name 

FS 

NT 
FW 

sc 

CN 

TW 

DP 

OT 

FN 

TN 

TT 

FA 

ZR 

TA 

OP 



Value 

20-24 
25 
26 
27 

35 

36 

37 

40-44 

45 

46-47 

57 

60-64 

65 

66-67 



Description 

FST entry (5 locations) 

Next track pointer 

FNT word count or central memory index 

Sector count terminal output 

\_*iVi. wtjFu UUiiCI- \D iOuct CJLUX155/ 

Constant 2 

Dayfile pointer address 

Origin type 

FNT entry (5 locations) 

Terminal number 

Terminal table address (2 locations) 

Address of FST entry 

CM zero word (5 locations) 

TELEX RA 

Output pointer (2 locations) 
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1RI JOB ROLLIN 



1RI performs job rollin response to a calling program, such as the job 1SJ scheduler or 
the system DSD display. 



IR = 



12 



12 



12 



1RI 





CP 


FN 1 


FA 



Where: 

CP = Control point number 
FN = 0, Rollin job. 

= 1, selective rollin according to special entry point 
FA = FST address of rollin file 

The 1RI dayfile message is "ROLLIN FILE BAD", signifying that an illegal format is 
detected in the rollin file (see Section 5, paragraph 5. 2 for a description of the rollin file). | 
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PRS 



\ 



*1 



Preset 
Routines 

Initial Rollout Operations 

i 

ERF 




Enter Rollout, 
k File 



^ 



/ /3RP/CKO\ *1 
v Check output 



Enter rollout file into FNT/FST. If DMP = 
call then file name is DM* and control point 
will not be dropped. 



Check for terminal input and output. 



/TxK. 



T 



RMS 



Request MS 
Space 



T 



CEQ 



Clear 

Equipment 



T 



L 



CFN 



Clear FNT 
Entries 



►* 



/3RP/RF& * 1 



Read first 

sector of 

terminal 
Voutput 



-dXYZl 



Request tracks for rollout file. 



Release all equipment assigned to this 
control point. 



Clear all FNT entries associated with this 
control point except the rollout file . 



Prepares terminal output file for TELEX 



* 1 Disable all jumps associated with TELEX origin jobs if this is. a 
non-TELEX origin job. 



Figure 6-14. 1RO - Rollout Job 
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Read FNT 
entry 



T 



Set file 
type = 
"ROFT" 




ves 



Clear FST 

address 

FA=0 



T 



RCH 




Reserve 
Channel 



wss 



Write 

System 

Sector 



fVVY 




Q 



Reset FST 
address 

FA 



T 



Set sector 
word count 
BFMS+1 



T 



7001 of PP 
memory PPU 
MS buffer 




TXT" 



Write File 
Name Table 



3RP/WTCT 

Write 
Terminal 

ntpnt, 

L_ 

JFL 



Write 
Job FL 



ZZZ 



* 1 See comment on previous page , 



Figure 6-14. 1RO - Rollout Job (continued) 
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DMP= call give control back to 
control point. Rollout file 

t6> onDM * 




Clear roll 
out flag in 
JCIW 



* 


Store FST/ 
FNT entry 
values in 
FS & FN 



So 1AJ can 
find the DM* 
file 




Complete Rollout Operations 



Call 1AJ into this PPU 
to advance the job which 
is now in SSJ= status. 



Drop job from 
control point 



Figure 6-14. 1RO - Rollout Job (continued) 
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1RI uses the ORF and ODF, drop file from rollout file, routine, and has the following 
location assignments: 



Name Value ■ ■ Description 

FS 20-24 FST entry (5 locations) 

DP 25 Address of dayfile buffer pointer 

EP 25 Entry point 

FT 26 FNT buffer index 

CI 27 Central memory index 

CN 30-34 CM word buffer (5 locations) 

PR 35 Queue priority 

TW 36 Constant 2 

OT 37 Origin type 

TN 40 Terminal Number 

TT 41-42 Terminal table address (2 locations) 

PP 43 POT pointer 

PA 44-45 POT address (2 locations) 

TA 46 RA of TELEX 

TI 47 TELEX FNT buffer index 

FA 57 Address of FST entry 

ZR 60-64 CM zero word (5 locations) 

EF 65 Error flag hold 
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PRS 



preset 
routine 



Read Roll^n File 

RCH 

Reserve 
Channel 



/ POS 
/ Position 
\ Disk 

I 
SYS 

Read 

System 
\Se ctor 



jL 



CPA 



A 



Read control \ 
point area / 



T 



DFB 



Read dayfile 
buffer 



T 



FNT 



Read FNT 
entries 





/ /3RH/TOP\* 1 
/ Skip terminal \ 
\ output / 

I 



JFL 



Read job 
k FL 



DCH 



Release 
Channel 



Rese t Jdb Stat us 

EFN 

Enter FNT 
.Entries 



T 

TX2' 




* 1 Disable all these if nontelex origin job. 

* 2 Set up control point area, put job in "W" 

status (RCPM) request. 

* 3 Drop FNT entry for this rollout file 

and drop all tracks. 




/3RH/TFN\ * 1 
Enter 
TELEX FNTs 



T 



DRF & ODI 

drop rollout 
file 



*3 



3ZZ 



assign 
equipment 




/3RH/EDA\ *1 
Enter data / 



T 



RSJ 



* 2 



reset job 



FTN 



Call 1SJ 
RSJM 



FTN 



Clear Job ad 
vancement 
lag JACM 




Figure 6-15. 1RI - Rollin Job 
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PRS 



press l 
routine 



Read Roll in File 



RCH 



Reserve 
Channel 



POS 



Position 

Disk 



SYS 



Read 

Svstem 
^Sector 



CPA 



Read control i 
point area / 



T 



DFB 



^ 



Read dayfile ) 
buffer / 





/ /3RH/TOP\ 

' Ski" terminal 



output 



T 



JFL 



Read job 

,FL 



DCH \ 



Release 
Channel 



Reset Jdb Status 



EFN 



Enter FNT 
.Entries 






1 Disable all these if nontelex origin job. 

: 2 Set up control point area, put job in "W 
status (RCPM) request. 

3 Drop FNT entry for this rollout file 
and drop all tracks. 




f /3RH/TFN\ * 1 
Enter ~~\ 

TELEX FNTs/ 



DRF & ODl 

drop rollout 
file 

I 
— AE'U» 

assign 
equipment 



*3 




Enter data 



RSJ 



reset job 




FTN 



Call iaj 
RSJM 



FTN 



Clear Job ad 
vancement 

' lag J ACM 




Figure 6-15. 1RI - Rollin Job 
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SYSTEM I/O (MASS STORAGE) 



7.0 INTRODUCTION 



All active files residing on Rotating Mass Storage (RMS) are described by a File Environ- 
ment Table (FET) and by a File Name Table (FNT). The FET is supplied by the user and 
resides within the job field length. The FET is described in Section 8. The FNT is supplied 
by the system and is used by system routines to coordinate user requests for I/O and file 
positioning. Only two other mass storage tables are involved with controlling I/O. 
These are the Equipment Status Table (EST) and the Mass Storage Table (MST). 

7.1 TABLE LINKAGE 

The linkage between these tables is simple and reduces system overhead to a minimum. 
Table linkage is: FNT -» EST -> MST. The FNT entry for a file consists of two CM words 
(Figure 7-1). The first word is the FNT word and contains the logical file name for the 
file. The second word is the File Status Table (FST) word and contains the file status, 
position, and equipment. The EST entry is one word which describes the device type, 
the channel(s), and a pointer to the MST entry for this device. The MST contains a com- 
plete description of the RMS device showing which tracks are-in use and which are 
available. A detailed description of these tables, all of which reside in CMR, is available 
in Section 2. 

7.2 MASS STORAGE TABLE 

MST entry can be thought of as a Track Reservation Table (TRT) with a 20B word header. 
The header words describe the TRT, as well as provide other pertinent system information 
describing the device. The TRT provides information about each track available on the 
RMS device. Since TRT sizes vary depending on the device type, the MST entries vary 
in size accordingly. However, each MST entry begins on a 10 B word boundary so that they 
can be addressed with the 12-bit field in byte 4 of the EST entry. The MST entries are 
built at deadstart time by a routine named SET. Permanent file information is taken 
from the LABEL track by routine RMS. The lengths of the TRT's are outlined in Table 
7-1. 
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FNT 
FST 



logical file name 


permis- 
sions 


file 
type 


1 


Ctl. 
Pt. 




EQ 


First 
Track 


Current 
Track 


Current 
Sector 


Status 



EST 




Channel 



Select/ 
Connect Code 



Device 
Type 



Address of 
MST/10B 



Q 



MST % 



TRT 



MST Header Words 



Track 
Reservation 
Table 



I 



X- > MSTL 



Figure 7-1. RMS Table Linkage 
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TABLE 7-1. TRT LENGTHS 

Logical Sector 

Device Mnemonic in CM Words Track Count Sectors/track buffer size 



6603 

6638 

863 

853/854 

ECS 

813/814 

821 

844 

DDP/ECS 

841 



DA 

DB 

DC 

DD 

DE 

DF 

DH 

DI 

DP 

MD 



1000 

1000 

100 

144 



4000 

4000 

400 

620 



dependent on ECS length 

1000 4000 

1000 4000 

624 3120 

dependent on ECS length 

620 3100 

(above values are octal) 



two zones 
61B 



153B 
100B 



502 
503 

all others 
502 



The TRT lengths above do not include the 20-word header. 

The TRT contains single -word entries that define up to four tracks, a link to another 
track, and control information. Bytes 0, 1,2, and 3 represent a particular track, while 
byte 4 contains three 4-bit control settings as follows: 



Byte 


Byte 1 


Byte 2 


Byte 3 


d 


w 


i 



where, 

Bytes 0-3 of a given TRT word represent a particular track. 

d - A bit is set corresponding to bytes 0-3 to identify the first 
track of a permanent file chain. 

w - A bit setting establishes an interlock of a track. Used by PFM.*1 

i - A bit setting for track reservation used by CPUMTR. 

From left to right, the three 4 -bit control settings correspond to bytes through 3, 
respectively. This is shown is figure 7-2. 



Track Reserva- 
tion Bits 



Byte 


Byte 1 


Byte 2 


Byte 3 








. 


k 


, 


i 


. 


i 


■ , 


1 


1 




3 |2 1 






i 










1 































Reserved / Flawed 
Track 



Figure 7-2. Bit Settings for Track Link Bytes 



*1 Both IPF and DPF's are interlocked as follows: For PFDUMP, the tracks 
are interlocked one at a time as they are dumped via the TRT w bits . 
For PFLOAD, the PF devices are interlocked one at a time as they are loaded 
via. the device unavailable for access bit in the EST. 
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The track link bytes either contain a pointer to the next track in the chain or indicate the 
end -of- information sector of a file. These two formats are shown in Figure 7-3. 



1 



Track Link 







EOI Sector 



Notice that the upper bit marks the difference 
between track link and EOI sector. 



Figure 7-3. Track Link Byte Format 

7.3 FILE LINKAGE 

Similar to the first and current track fields in the FST, the track link byte contains a 
number which can be broken down to determine the word within the TRT and the byte within 
that word which is used to represent the track number. That is, the general link byte 
format which follows : 



where, 

Z 
Z 
X 
Y 



11 


10 987 65432 


1 


|z 


XXXXXXXXX 


Y Y 



1 for next link in chain in bits 0-10. 
for EOI sector number in bits 0-10 
TRT word relative to word of this TRT 
byte within word X. 



Figure 7-4 is an example showing file linkage from FST to EST to MST. Notice that the 
file occupies space on tracks 5, 12, 14, 15, 16, 17 and 20. The EOI is sector 7 of track 
20. The EST entry shows that the device is a 6638 so that MST entry is 1020B words 
long. Also, the FST entry shows that the file is currently positioned at End-Of-Information 
(EOI). TRT linkage can also go backwards (4012-»-4002-*-4007, etc.). 

7.4 DISK SECTOR 

Every sector, as seen from the user, contains up to 64 CM words (100B). However, the 
system always prefixes the sector with two header bytes (24 bits). These two header 
bytes contain file linkage and other information. The general format of a disk sector is 
shown in Figure 7-5. 
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Figure 7-4. Example of File Linkage 



Header 

Byte 1 



Header 
Byte 2 



From 0- 100B CM 
Words of Data 



1 Refer to Section 2 (page 2-24). 

Figure 7-5. Disk Sector Structure 
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There are four types of sectors known to the system and marked via the header bytes 
These are: 

• EOR - end-of-record sector 

• EOF - end-of-file sector 

• EOI - end-of-information sector 

• S.S.- system sector 

Header byte 2 contains a word count of the number of CM words within the sector as 
written by the user. The Word Count (WC) is in the range to 100B. If the word count 
equals 100B, the sector is full. If the word count is less than 100B, the sector is called 
a short PRU and indicates an End-Of-Record (EOR). Table 7-2 shows the relationships 
between the various sector types and the contents of the header bytes . 

TABLE 7-2. SECTOR HEADER BYTE CONTENTS 



Sector 
Type 


Header Byte 1 


Header Byte 2 


Comment 


EOR 

EOF 
EOI 
S.S. 
F.S. 


Next Sector/ Track 



3777B 
Next Sector/ Track 


< WC < 100B (PRU) 

Next Sector/Track 

77B 
WC = 100B 


may or may not contain 

data 
no data 
no data 

system data only 
full sector 



In Table 7-2, F.S. represents a full data sector and differs from an EOR sector by WC = 100 
rather than WC< 100 as for the EOR sector. 

I To differentiate between next sector and next track in header byte 1, bit 2 is set. That 
is, bit 2 is set to indicate a link to another track rather than a link to the next sector. 

The PP common decks that read /write mass storage perform the reading and writing of 
the header bytes. Also, CIO reads/writes the header bytes for disk I/O. Finally, macros 
READCW and WRITECW are available to read and write mass storage and magnetic tape 
files using control words (i.e., header bytes). The PRU format for READCW and 
WRITECW is in the KRONOS 2. 1 Reference Manual. 

Again, in Table 7-2, the system sector (S.S.) for a file is indicated by special header 
byte values. This is done to prevent accidental reading through the system sector itself. 
SS is always sector of the first track of a file. 

Examples of the various sector types are shown in Figure 7-6. The device is assumed to 
be a 6638; therefore, the sector count is from to 60B. Two situations not shown in 
Figure 7-6 are an EOR and an EOF as the last sector on a track which link to the next track. 
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Sector 

Number 



60 



First 
Logical 
Track 



Second 
Logical 
Track (5) 



3777 






1 

2 
3 


0001 




0077 






0022 


System 
Sector 


EOR 








0002 


«• — 


0002 


1 

1 
1 

1 


0100 




0100 


All 
Data 


All 

Data 








0003 


t — 1 


0000 


0042 


0003 




EOR 


EOF 








0004 


4 ' 


0000 


< 


0100 


0000 




All 
Data 


EOI 




• 
E 

* 




» 
t 
* 




4005 








0100 










All 
Data 


60 







Sectors 4-60 
are not used 



Figure 7-6. RMS File Structure 
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PP ROUTINES 



Any PP routine requiring disk I/O performs READ/WRITE operations according to the 
flowchart in Figure 7-7. 

A PP routine which writes the disk should begin by issuing monitor function AMSM. AMSM 
is used to allow MTR to select the best device on which to perform the write. Monitor's 
device selection criteria are: 

1. Unrestricted device with channel free 

2. Unrestricted device with channel busy 

3 . Restricted device with most space 

If a system device is required, the monitor function RSYM should be used instead of AMSM. 
Referring to Figure 7-7, monitor function RTCM provides a track chain for the requesting 
PP routine. The PP specifies N sectors and monitor returns the first track of a chain of 
tracks. If the PP routine exhausts the N sectors, additional RTCM functions will be 
required. 

The PP Resident routine SMS determines which driver is currently loaded, and if a dif- 
"JFerent driver needs to be loaded, calls PLL. SMS jumps to MSD+3 after the driver is 
loaded to perform preset operations . After returning from SMS, the PP routine can use 
the three driver entry points: 

POS - position disk 
RDS - read sector 
WDS - write sector 

These entry points are entered via the RJM instruction. After a write operation, the PP 
program must issue the monitor function DTKM to drop any remaining tracks and set the 
EOI sector in the TRT. (This is not done, however, for rewrite-in-place. ) The DTKM 
function is described in Section 3 but is reviewed here. The PP sets up its output register 
as follows: 



CM 



CM+1 



CM+2 



CM+3 



CM+4 



DTKM 


EST 
Ordinal 


First 
Track 


Last 
Sector 


not 
used 



where. 



First Track = the last (current) track written. 

Bit 2 11 of this byte is set to so that CPUMTR drops all tracks after 
this track and stores "last sector" value in track byte in TRT. If bit 
2^ = 1, "last sector" value is ignored and all subsequent tracks are 
dropped by CPUMTR. 
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Input to 
Subroutine 



(T5)=EQ "\ 





© 




Monitor 
Functions 



PP to MTR 



RTCM 


EQ 


Track 


Sector 

Count 





Response- 






EQ | 




TK 






irst 
Track 
Assigned 



© 



(A) = Channel ;> 



(T6)=Traek 
(T7)=Sector 
(POSA)=FWA of, 
MST/10B £ 
4) (Set by SMS) 
T4.T5 



© 



© 
© 



(A)=FWA of 
buffer 



Set error 
Processing 
Options in 

¥ERP 




MONITOR 
Drop re- 
maining 

tracks. set 
DTKM 

r — 




DTKM 


EQ 


Track 


&&r 



Figure 7-7. Disk I/O from PP Routine 
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The values above are picked up from direct cells being used as input values to WDS. 
That is, the contents of T5 can be stored in CM+1, since T5 contains the EST ordinal. 
The contents of T6 are stored in CM+2 and the contents of T7 are stored in CM+3. 

A new monitor function was added to KRONOS 2.1 called SCHM. With this function, a 
PP routine can request that monitor select a channel for a device when more than one 
channel is available. This monitor function is used by certain disk drivers to support 
dual access devices. The drivers that use the function are: 

6DH -821 driver 
6DI - 844 driver 
6DP DDP/ECS driver 
6MD- 841 driver 

Although these drivers get a channel selected by monitor, it is still necessary for the 
calling PP routine to reserve the channel with the RCHM monitor function. That is, 
the SCHM function does not reserve the channel. Along with this feature, the driver (or 
MTR) issues a release function to the controller after I/O is completed so that the unit 
is available to another PP on another channel. In this manner, KRONOS 2. 1 supports the 
dual access configuration shown in Figure 7-8. 



Device Device 



yy vy yy 




Device 
2 




Channel 

M 



Figure 7-8. Dual Access Configuration 
(Single Mainframe) 



Besides dual access support, much has been added in the area of error detection and 
correction. Of importance to the system analyst is the error processing options now 
available with PP programming. Any PP program can select one of the following options 
when performing disk I/O: 
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• return control on read error (2 ) 

• return control on write error (2 ) 

• return control on not ready or (2 ) 
reserved status 

These options are selected by setting bits 2 , 2 , or 2 respectively in PP Resident 
at the location named UERP . SMS initializes UERP to zero and the program can select 
the appropriate flag immediately after returning from SMS. For selecting "return on read 
error", the program can contain the following instruction: 

AOM /MSP/UERP 

When reading, data within the sector is validated based on the following criteria: 

t) The word coiart {WO in the header byte is less than or equal to 100B. 
2) The next sector link in the other header byte is valid. 

A return from RDS or WDS with error status is indicated by (A)< 0. If the PP common 
deck, COMPRNS , is used to read sectors, a return jump to MSR is made when a read 
error is encountered. The subroutine MSR is supplied by the programmer and should 
process the read error. To indicate that MSR is available to COMPRNS, it is necessary 
to define MSR$^0 during the assembly of the PP program. 

Flowcharts from 6DB, the 6638 Disk Driver are shown in Figure 7-10 through 7-14. 

PRS is entered from SMS while the other three routines POS., RDS. and WDS. are entered 

via RJM instructions to POS, RDS and WDS, respectively. 

All disk drivers are originated at location 600B for loading into PP Resident. The first 
location (600) contains the device type in display code for driver identification. That is, 
SMS can determine w hether or not a n e w driver must be loaded . — The-rt ext t w o location s 
(601, 602) contain sector limit values. For example, both cells contain 61B and 153B 
for 6DB and 6DI. respectively. The next location 603 contains an entry point to the 
PRESET subroutine within the driver. This is used by SMS only via the following instruc- 
tion: 

ZJN MSD+3 DRIVER ALREADY LOADED 

Following this are the three entry points: 

606 POS - Position Disk 
612 WDS - Write Sector 
616 RDS - Read Sector 

The symbols POS, WDS, and RDS are defined in PPCOM and are the same for all drivers. 
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547 
600 
601 
602 
603 



604 


605 


POSX 606 


POS 607 


610 


611 


WDSX612 


WDS 613 


614 


615 


RDSX 616 


RDS 617 


620 


621 



SMS 



Driver Name 



Sector Limit Zone 1 
Sector Limit Zone 2 

Preset Code for the Driver 

LJM 

PRS of Driver 

POS Subroutine 

Macro 

LJM 

POS. 

WDS Subroutine 

Macro 

LJM 

WDS. 

RDS Subroutine 

Macro 

LJM 
RDS. 

POS. 

RDS. 
WDS. 



7000 
7001 



PRS for Driver 



Buffer 



Figure 7-9. MS Driver Core Map 
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The routine PRS is overlayed with error processing code. This code and the dayfile message 
is received from MTR in MB - MB+5 after the requesting PP routine issues monitor function 
DEPM. The code to perform the error processing is loaded at PP location 7510 and is 
contained in overlay 7DB. The error processing code received from MTR simply issues 
the dayfile error message unless UERP is set, requests the disk channel, and passes 
control to the ERX routine. If UERP was not specified, ERX returns to RDS/WDS. If 
user error processing had been specified via UERP, the error processing code passed from 
mointor will return control to the caller of RDS/WDS after N retries. Figure 7-10 describes! 
the above operation. The encircled numbers represent the sequence of events. 



PPW 



CM 



MTR 







7510 



WDS code 



ert 



E.P. code 
from MTR 
overlays PRS 



RJM WDS 



7DB 
E.P. code 




E.P. code and 
return info. 



s> 



DEPM 
code 



E.P. code 



© 



tSL 



Call MTR 



Description 

1 . A call to WDS made 

2. WDS detects error and calls 7DB. 

3. 7DB calls MTR with DEPM function. 

4. MTR stores error processing code and return information in message buffer. 

5. 7DB moves E.P. code from MB to EXIA, thus overlaying PRS routine in driver. 

6. 7DB passes control to that code. 

7. E.P code executes and passes control to ERX. 

8. If no UERP, retry WDS "n" times. If maximum retries, wait for GO/DROP 
from operator. 

8' . If UERP specified and max. retries, pass control to caller of WDS. 



Figure 7-10. Disk I/O Error Control 
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The following can not happen: 

During a read/write on disk, an error occurs, and while trying to issue the error message, an 

error occurs on the device to which we were writing the error. 

Because errors are written to dayfiles and not to devices . When the dayfile buffer is finally 
written to a device by 1DD, the mass storage driver will not attempt to issue any error 
messages, but normal corrective action is attempted. If all attempts fail, then the operator 
is informed via the console dayfile if possible. 
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The following functions are flowcharted in Figures 7-11 through 7-15. 

PRS 
STS 
POS 



- Preset 

- Check Status 

- Position Disk 



RDS - Read Sector 
WDS - Write Sector 



Entry: (CM - CM+4) = EST entry 



Exit: (A) = Controller Status 



MPRSj 



Set FWA of 
MST/10B in 
POSA for POS 



Modify I/O 
instructions 
with channel 
number 



Set Select 
and Connect 
Code in 
STS & POS 




Select 
Status 

FNC Code, CH 

Input 
Status 

ACN CH 
IAN CH 



Disconnect 
Channel 

DCN CH 



LJM 
iSMSXJ 



Store Status 
in STSA for 
message 
generation 




Figure 7-11. PRS - PRESET 



Figure 7-12. STS - Check Status 
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Entry: (POSA) = FWA/10B of MST entry. Set in PRS. 
(POSJ 




Compare current track as specified 
in word MSDL of MST with requested 
track as specified in T6. Compare 
physical tracks . 



Select 
Track 
(T6) 




Select 

Head 

Group 

Fan CH 



X 



Store new 
position in 
MSDL word 
in MST 



- Exit LJM POSX 



Figure 7-13. PCS - Position Disk 
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Entry: (A) = FWA of PP buffer to contain sector 
Exit: (A) < if unrecoverable parity error 



Store buffer 
address in 
IAM instruc- 
tion 



Set reread 
count = 
(RDCT) 




Exit ZJN RDSX 



Figure 7-14. RDS - Read 'Sector 
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Entry: 



(A) = FWA of PP buffer containing sector 

ros. 




Store buffer 
address in 
OAM instruc- 
tion 



Set reread 
count = 



execute 
7DB 




7DB 



STS 



Check 

Status 



ERX - Error exit processing 




POS 



Position 
Disk 



Return to 
RDS/WDS or 
to caller 
of RDS/WDS 



Figure 7-15. WDS - Write Sector 
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7 . 6 SYSTEM SECTOR 

The system sector is the first sector of a mass storage file and contains system information. 
PP routines that write mass storage files begin by writing a system sector. Such routines 
include CIO, 1TA, 1RO, and others. The system sector is generally written via the PP 
common deck, COMPWSS. Although the calling routine stores various system information 
in the system sector, COMPWSS stores the control (header) bytes, the FNT/FST, and the 
date according to the format shown in Figure 7-16. System information varies with differ- 
ent routines. For example, a rollout file's system sector includes dayfile buffer pointers, 
a copy of the input file's FNT/FST, any operator assigned equipment, and terminal table 
information for time-sharing jobs. 



3777 



0077 



FNT entrv 



EQ 



FT 



0000 



0000 



FA 



Packed Date from PDTL in CMR 



system 

information 



where, 

EQ = EST ordinal of this equipment 

FT = first track of this file 

FA = address of FST entry 

Figure 7-16. System Sector Format 

Finally, system sectors are useful in untangling taagledaup!fli6k JHes-as tim&iBrididate.v-will 
give an idea of when the file was written. 
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7.7 MASS STORAGE CONTROL AND INITIALIZATION 




CONTROL CARD 

BUFFER 



Mass storage control and initialization is controlled by the system dynamically. ISP will call 
ICK and CMS periodically according to assembly constants defined in CMR JSCL + 1 word 41 
and PFNL + 1 word 111. Figure 7-17 shows this interaction. The other figures show an example 
of an MST and a LABEL track. 

1. ISP calls ICK if time period 
elapsed and checkpoint request 
is present in MST (every 30 
seconds) . 

2. ICK will copy the CMR MST/TRT 
to the label track and drop. 

3. ISP initiates CMS (transient PP) 
via dummy FNT job entry if: 

a . Initialize request or 

b. Time period elapsed (1 minute) 

4. CMS will be started in a PP 
by ISP. 

5. CMS checks for an Initialize 
request and if present initiates 
MSI (via CC call) . 

6. CMS 

a. Checks labels of active 
devices and verifies with 
resident MSTs. 

b. Logically removes inactive 
d evic es not p hysical ly present 
(removable only) . 

c . Logically receives new devices 
if label is recognizable: 

- Recover TRTs . 

- Verify "PF system. 

- Clean up any DA interlocks. 

d. Drop from PP. 

7. MSI interacts with the OPERATOR via K display to set initialize parameters. 

8. MSI calls the service PP, IMS. 

9 . IMS initializes the device(s) and then drops . 

10. When IMS Is complete, MSI calls CMS and ends (i.e. drops from the CP). 

11. CMS verifies the initialized device(s) and its corresponding MST/TRT in CMR and drops. 



Figure 7-17. Mass Storage Control and Initialization 
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TABLE 7-3. DESCRIPTION OF MST 



Word 


Bits 


Description 





36-59 


401205 available sectors 




24-35 


624 words in TRT 




11-23 


empty 




0-11 


2317 TRKs available 


1 


48-59 


N/A 




47 


FORMAT PACK not pending 




46 


don't release reservation on channel release 




45 


Reserved 




36-44 


1 unit sec limit = 153 




18-36 


sector limit = 153 




0-17 


sector limit = 153 


2 & 3 




reserved for MS drivers 


4 


48-59 


260 is 1st track of Indirect 
PF chain 




3 6-47 


is label track 




24-35 


261 is 1st track of permit info 




11-23 


catalog track count is 20 




0-11 


system table track is 262 


5 


48-59 


7042 is 

111000 100 010 

555 555 555 544 

987 654 321 098 bit. 




- which means 


MS device 59 
System on device 58 
PF on device 57 
Direct PF on device 53 
TEMP device 49 




24-47 


Reserved 




12-23 


current direct access files 

in use = 3 (VALID UX, RESEXDF, RESEXUF) 




nil 


device in use 

device not busy bit is on. 


6 


18-59 


Family name is MORR1 




12-17 


device number is 40 




11 


catalog tracks not continuous with Label Track. 




10 


catalog tracks have not overflowed 




8-9 


reserved 




0-7 


mask is 377. 
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TABLE 7-3. DESCRIPTION OF MST (Continued) 
MST ADDRESS = 4300 



004012 
777701 
000000 
000000 
426040 
704200 
151722 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



05062400 
53000153 
00 00 00 
00000000 
00 4 2 6100 
00000000 
22110000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 



00231 7 
000153 
000000 
000000 
204267 
030005 
400377 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



TABLE 7-4. DESCRIPTION OF LABEL TRACK 



Sector number (SE) 


Description 







System sector 


Word 


-1 


Header bytes Bl =37777, B2=77 







FNT see p. 3-19 of instant 




1 


Eqss = eg. =0, 1st track = 




2 


Date = July 2, 1974, time 12.14.56, 
updated at every level Dead Start 




3,4,5,6,7 


Empty all part of standard system sector 




10,11 


Empty 




12,13 


Used for 2.0 PF compatability 




14 


Catalog descriptor entry 
Bits 0-11 Empty 

12-23 Mask 

24-35 Number of catalog tracks 

36-60 Empty 




IS 


Track descriptor 
Bits 0-11 Empty 

12-33 1st track permit 

24-35 Empty 

36-47 1st track of indirect file 
chain 

48-60 Empty 




16 


Bits 0-23 Empty 

24-35 Sector number for continuation of 
label track (all tracks) on next 
spindle for multi-unit devices. 

36-47 Sector limit 

48-60 Device type 
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TABLE 7-4. DESCRIPTION OF LABEL TRACK (Continued) 


Sector number (SE) 


Description 


17 


K 2 . compatability 




Bits 0-35 Empty 




36-47 Word count of mass storage 




table =20 words 




48-60 Catalog ordinal biased by 40 


20 


EST entry 


21-30 


1st 10 words of MST 


31 


Password for removable device 


32-77 


Unused 


1 + however many needed 


copy of TRT 


Foil 


Description 


1 


Listing of label tracks documentation 




from COMSDSL. 


2 


DUMPTK of LABEL from DI-1 




eq 0, SYSTEM and PF device. 


3 


Continuation of 2. 



CALLSYS - CALL SUB-SYSTEM COMMON DECKS, 73/08/29. 11.57,30. 
COMSDSL - DEAD START LOAD PARAMETERS . 
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TABLE 7-S. DEFINITIONS FOR DEVICE LABEL SECTOR.* 



Byte 
Number 



Word 

Number 



Definitions 



7026 
7076 
7100 
7101 
7104 
7105 

7106 



14 



IS 



7110 


16 


7111 




7112 






* 




* 


7115 


17 


7116 




7122 


20 


7127 


21 


7177 


31 


7204 





.1 SET BFMS+2+4*5 

CESS EQU .1+10*5 CATALOG DESCRIPTOR ENTRY 

CCSS EQU .1+10*5+2 CATALOG COUNT 

CDSS EQU .1+10*5+3 DEVICE MASK 

DASS EQU .1+11*5+1 FIRST TRACK OF INDIRECT FILES 

ALSS EQU .1+11*5+2 LABEL TRACK (LINKED TO CATALOG 

TRACKS). 

PRSS EQU .1+11*5+3 FIRST TRACK OF PERMITS. 

ETSS EQU .1+12*5 EQUIPMENT TYPE 

SLSS EQU .1+12*5+1 SECTOR LIMIT 

SNSS EQU .1+12*5+2 SECTOR NUMBER FOR MULTI UNIT 

DEVICES 

THE FOLLOWING 2 WORDS ARE USED FOR PURPOSES OF FUTURE 
COMPATIBILITY. 



coss 


EQU 


.1+13*5 


wess 


EQU 


.1+13*5+1 


ESSS 


EQU 


.1+14*5 


MTSS 


EQU 


.1+15*5 


PWSS 


EQU 


.1+25*5 


LMSS 


EQU 


.1+26*5 



CATALOG ORDINAL (BIASED BY 40) 
WORD COUNT OF MASS STORAGE TABLE 
EST ENTRY 

FIRST WORD OF MASS STORAGE TABLE 
PASSWORD FOR REMOVABLE DEVICE 
LIMIT OF CHECK OF LABEL DATA 



These are in byte counts: 

. 1 equ 4 so 

CESS is 4 + 10 = word 14 
CCSS is 4 + 10 = word 14 
CDSS is 4 + 10 = word 14 
DASS .is 4+ 11 = word 15 

etc. 



*5 = byte 
*5 + 2 = byte 2 
*5 + 3 = byte 3 
*5 + 1 = byte 1 



*This information is from common deck COMSDSL. 
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8.0 INTRODUCTION 

Combined Input/Output (CIO) processes input/output requests for CPU programs. Data 
transfer between CIO and the CPU program is handled via a buffer within the CPU program's 
field length. This buffer is known as a circular buffer because CIO treats the last word 
and the first word as contiguous . The circular buffer is controlled via a File Environment 
Table (FET) which is also within the job's field length. The FET not only describes the 
buffer, but also holds the request code being issued to CIO. Figure 8-1 shows the relation- 
ship between CIO, the FET, and the circular buffer. For a write operation, at least one 
PRU of data should be in the buffer. For a read operation, the buffer must have room 
to receive one PRU of data. Less than one PRU of data is transferred only if an End-Of- 
Record (EOR) is read or written. 



FET 



Ifn 



Code 



FIRST 



OUT 



LIMIT 



Circular 
Buffer 

~m~r 



IN ~ ► 




Space for 
Data 




CIO 




Figure 8-1. User /CIO Interface 

The FET formats for mass storage and magnetic tape files are shown in detail in Section 7 
(Figures 7-4 and 7-5) of the KRONOS 2. 1 Reference Manual. 

Equipment which may be accessed by CIO include: 

• Mass Storage MS 

• Magnetic Tape MT 
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• Card Reader CR 

• Card Punch CP 

• Line Printer LP 

• Line Printer (512) LQ 

Routines used by CIO include: 



• OBF - 


begin file 


• ODF - 


drop file 


• 2LP - 


write line printer 


• 2PC - 


write card punch 


• 2RC - 


read card reader 



The only routine called by CIO is 
• DMP - dump memory 

CIO consists of the following overlays: 

CIO - main routine and termination 

2CA - identify special request 

2CB - read mass storage 

2CC - special mass storage reads 

2CD - write mass storage 

2CE - special mass storage writes 

2CF - position mass storage 

2CG - terminal input /output 

2CH - magnetic tape operations 

2CI - error processing 

2CJ - device error processor 

The call to CIO is formatted as follows: 

59 48 47 424140 36 35 18 17 



C I 


O 





R 





skip count 


FET address 



R = 1 if auto-recall is desired 
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CIO Memory Map 

Figure 8-2 describes PP memory as allocated by CIO. The symbol MSDO is the origina- 
tion address (ORG) for the mass storage drivers, 2CB and 2CD. The symbol DRFW is the 
load address for overlay 2CG and for drivers 2LP, 2PC, and 2RC. The symbol OVL is 
the load address for overlays 2CA and 2CH and for zero level overlays, OBF and ODF. 
The symbol ERPO is the load address of the error processing overlays, 2C1 and 2CJ. 
ERPO follows the last word of the longest overlay, namely, 2CF. Boxes to the right of 
CIO represent the various overlays called by CIO and their relative lengths . Not shown 
are any of the overlays and drivers loaded at DRFW. These include 2CG, 2LP, 2PC, and 
2RC as stated above. OBF and ODF are also not shown. CIO routines are shown in greater 
detail in Figure 8-3. The logic flow-through CIO is shown in Figure 8-4. 



100 



1100- 



MSDO . 

DRFW. 
OVL - 



ERPO 



PP 
Resident 



-*- 



Termination 
Routines 



Resident 
Processors 



Resident 
Subroutines 



MSDO 



MSDO 



! Tables 



J CIO Subroutines 



♦1 Initialization 




OVL 



0VL 



2CA 



2CH 



ERPO 



2CJ 



Figure 8-2. CIO Memory Map 
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i 


.. 


PPFW"*" 








UFS - 


Update File Status 




IOF - 


Set IN=OUT=FIRST 




CFN - 


Complete Function 




ERR - 


Process Error 




CNR - 


Complete Null Read 




DRF - 


Drop File 




FMS - 


Function Mass Storage 




REW - 


Re-wind Mass Storage 




MSP - 


Complete M.S. Processing 




IMS - 


Initialize Mass Storage 




MSR - 


Process M. S. Error 


MoDU '" 'r 








TREQ- 


Request Codes 




TRDO- 


Read Processors 




TWTO- 


Write Processors 




TFCN- 


Function Equipment 




EFN - 


Enter File Name 




FUE - 


Func. Unknown Eq. 




RUE - 


Read Unknown Eq. 




SSC - 


Set Skip Count 


DRFW-*- 


WUE - 


Write Unknown Eq. 










CIOl - 


Read Buffer Status 




IRQ - 


Identify Request 




SAF - 


Search For File 




SFS - 


Set File Status 




CFA - 


Check File Access 




CBP - 


Check Buffer Parms. 




PFN - 


Process Function 


< 


■ 


< 



Termination 
Routines 



Resident 
Processors 



Resident 
Subroutines 



Tables 



CIO Subroutines 



Initialization 



Figure 8-3. CIO - Main Overlay 
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frinu J^prj 



Resident Subroutines in CIO 
iFUE) (WUE) (RUE^ 




PFN) Process Function 




Resident 
Subroutine 






2CB 


2CD 


FMS 


2CG 


2CG 


2CH 


2CH 


2CH 




2RC 


2LP 

2PC 






*■» 


mf 







-*{UFS 



Figure 8-4. CIO Logic Flow 



97404700B 



8-5. 



8.1 CIO INITIALIZATION ROUTINES 

Figures 8-5 through 8-10 are flowcharts for the following CIO initialization routines: 

CIOl/IRQ 

SAF 

EFN/SFS 

CFA 

CBP 

PFN 

The PFN routine searches one of three tables (TRDO, TWTO, or TFCN) to get the name 
of the overlay to be executed. The three tables are formatted as shown in Table 8-1 
through 8-3. 

TABLE 8-1. TRDO - TABLE OF READ PROCESSORS 



Equipment 


Entry Point 


Overlay Name 


MS 


RMS 


2CB 


TT 


■no 


2CG 


MT 


PMT 


2CH 


NT 


PMT 


2CH 


CR 




2RC 





RUE 


(Read unknown 
equipment) 



TABLE 8-2. TWTO - TABLE OF WRITE PROCESSORS 



Equipment 


Entry Point 


Overlay Name 


r~ ms 


WMS 


2CD 


TT 


■no 


2CG 


MT 


PMT 


2CH 


NT 


PMT 


2CH 


LP 




2LP 


LQ 




2LQ 


CP 




2PC 





WUE 


(write unknown 
equipment) 



TABLE 8-3. TFCN - TABLE OF FUNCTION PROCESSORS 



Equipment 


Entry Point 


Ove 


rlay Name 


MS 


FMS 




(resident) 


MT 


PMT 




2CH 


NT 


PMT 




2CH 





FUE 




(function unknown 
equipment) 
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clear FST 
address FA 
random fnc. 
RF 



select 
error 
processing 
4007 EO 




Advance to 
next entry 
in TREQ 



EXR 



Read buffer 
status, 
FIRST and 
LIMIT 




A r sfument 
Error 



Identify Request 



Initialize 
for search 
of TREQ 



i Set skip 
\ count 




save level 
number and 

binary/ coded 
bit-+MDA 



SAF 



identify 
special 
request 



ISRT 




Figure 8-5. CIO Initialization 
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© 



read FNT 
pointer 
(FNTP) FS 




read next 
FNT entry 
into CM 




_3zes- 



EFN 



enter 
new 
file 
in FNT 



compare file 
names and 
control 
point numbers 




no 



set FST 
pointer 

► FA 



«. SFS 



Figure 8-6. SAF - Search for Assigned File 
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! EFN! 



clear FST 
address in 
FA and equip 
assignment 
in FS 




set 
IN=OUT=FTRS1 



s^ error V yes J ERR 



sjERR File name 
Error 




File 

Sequence 

Error 



HCFA 



fSFSJ 



store FNT 
I entry in 
J MB for 
I monitor 



read FST 
entry— •■FS 
FNT entry 
*CM 



CFA 




no J £RR File 

Sequence 
Error 



Figure 8-7. EFN - Enter File Name and SFS - Set File Status 
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set upper 
status for 
completion 
routine 




Pick up EQ 
type from EST 
entry 





store EQ 
type in PFN 
routine in 
FCB 




set write 
function 
table address 
TWTO . FCA 




set 7/9 
track format 
density, & 
labeled flag 



set FNT 
address in 
LIMIT word 
in FET 




ves 




yes 



yes 



FC = evict > £2£_J DRF 




set function 
table ad- 
dress 
TFCN-*. FCA 




read random 
request 
word from 
FET +6 



CBP 



Figure 8-8. CFA - Check File Access 
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Entry - FIRST and LIMIT already read by CIOl 
fcBPJ 



read 

IN/ OUT 




> limit >_Z£5 JcBP 1) 




no 




limit > FLS-^ -(CBP 1 



> li~i^ > yes JcBP 1 



yes 





BPir 



BUF 



-ERR 



Figure 8-9. CBP - Check Buffer Parameters 
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Entry - CFA has set: 

• FCA = TRDO, TWTO or TFCN 

• FCB = Equipment type from EST 

Exit - Jump to routine selected from table 




search table 
for 

matching 
equipment 



yes 




Jump to 
RUE or 
WUE or 

FUE 




-X£S_ 



clear error 
proccessing 
flag 




Jump to 
resident 
routine 
(FMS only) 



(A ) ^overlay 
selected to 
process fnc. 



(PFNa 





* UERP = User Error Processing 



Figure 8-10. PFN - Process Function 
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8.2 CIO ERROk, MESSAGES AND ROUTINES 

Error messages from CIO are numbered and identified by a unique three character name. 

Subroutines issuing an error message do so with the following code: 

LDN | ERR | XXX 
LJM ERR 

where XXX is the unique name . 
All error messages are in overlay 2CI Table 8-4. 

TABLE 8-4. OVERLAY 2CI 



Name 



ARG 

BLE 

BUF 

DRE 

EXO 

FLN 

F3Q 

IFE 

IFM 

IRQ 

IWR 

RAD 

RUD 

RWT 

TKL 

TNA 



Message 



FET ADDRESS OUT OF RANGE 
BUFFER CONTROL WORD ERROR ON 
BUFFER ARGUMENT ERROR ON 
DEVICE ERROR ON FILE 
I/O ON EXECUTE ONLY FILE 
ILLEGAL FILE NAME 
I/O SEQUENCE ERROR ON FILE 
ILLEGAL EXTENSION OF 
ILLEGAL MODIFICATION OF 
ILLEGAL I/O REQUEST ON FILE 
WRITE ON READ ONLY FILE 
RANDOM ADDRESS NOT ON FILE 
REQUEST UNDEFINED ON DEVICE 
INDEX ADDRESS OUT OF RANGE FOR 
TRACK LIMIT, FILE 
M.T. NOT AVAILABLE ON FILE 



The logical file name and FET address follow the above messages. The error processing 
subroutine ERR is flowcharted in Figure 8-11 and the overlay 2CI called by ERR is flow- 
charted in Figure 8-12. 
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Entry - (A) = Error Number 




Store error 
number in 
ERRA 



/ EXR 
' load and 
V execute 
\ 2CI 



Figure 8-11. ERR - Process Error 
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set IBQ 

error 

code 



MONITOR 



set error 

flag 

CEFM 



clear file 
busy status 
in FST 



clear/ store 
filename in 
message 




nrr<3 



return 
detailed 
error 
status 




DFM 



issue 

dayfile 

message 




clear error 
\ flag / 

X CEJM 7 



set LWA +1 
of dump = 
FE'T + length 



set FWA of 
dump = FWA 
of FET 



store DMP 
call in ctl. 
pt. area + 
SPCW 




Figure 8-12. ERP - Error Processor (2CI) 
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8 . 3 2CA SUBROUTINES 

Figures 8-13 and 8-14 are the flowcharts of the three subroutines in overlay 2CA . These 
are: 

ISR - Identify Special Request 

EVF - Evict Mass Storage File 

EPF - Evict Permanent File 

Table 8-5 TREQ is searched to map the request code in BS+4 into a function code stored in 
FC. The table contains the following entries. 

TABLE 8-5. TREQ 



Request Code 


Function Code Name 


Description 


0100 


OPE 


OPEN, READ, NO REWIND 


0104 


OPE 


OPEN, WRITE, NO REWIND 


2110 


OPE 


Position multi-file set 


0114 


EVI 


EVICT 


0120 


OPE 


OPEN, ALTER, NO REWIND 


0130 


CLO 


CLOSE, NO REWIND 


0140 


OPR 


OPEN, READ, REWIND 


0144 


OPR 


OPEN, WRITE, REWIND 


0150 


CLU 


CLOSE, REWIND 


0160 


OPR 


OPEN, ALTER, REWIND 


0170 


CLU 


CLOSE, UNLOAD 


0174 


CLU 


CLOSE, UNLOAD, RETURN 


0300 


OPE 


OPEN, READ, NO REWIND 


0330 


CLO 


CLOSE, NO REWIND 


0340 


OPR 


OPEN, REWIND 


0350 


CLU 


CLOSE, REWIND 


0370 


CLU 


CLOSE, UNLOAD 



8.4 2CB SUBROUTINES 

Figures 8-15 through 8-20 are flowcharts of subroutines in overlay 2CB - Read Mass 
Storage. The following is a list of those subroutines; an asterisk indicates which ones are 
flowcharted . 



*RMS 
*LDB 
*WCB 
*EOF 
*EOR 
*CPR 
CBS 
SBA 



Read Mass Storage {Main Routine) 

Load CM Buffer 

Write Central Buffer 

Process EOF 

Process EOR 

Complete Read 

Check Buffer Space 

Set Buffer Addresses 
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(isr) 

T 

Search table 
of request 
codes TREQ 



matcli\no 
found 




yes 



Set "open" 

status in EFN 
routine 



IRQ 

ERR, 






-22 «/lSR3) K^C = CLOSE> — 2S^. 




No 



Store 
"close" 
mask in CFA 
.routine 



Figure 8-13. ISR - Identify Special Request (2C.A) 
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(evf) 




Return 



Read 
FNT 





clear 
current 
track, sector 
and status 




VF2Y 



MONITOR ~\ 
drop track \ 
chain / 





Set file 
"modified' 
in CFN 



MSR 



process 
mass 
storage 
errors 



Figure 8-14. EVF/EPF - 2CA Subroutines to 

Evict a Mass Storage and Perma- 
nent Files 
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no 




Figure 8-15. 2CB - Read Mass Storage 
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r-Yes 




Length = 
OUT - IN+1 
± LIMIT - 
FIRST 




Advance 
sector 
count 
PC=PC+1 





Next sector 
— >- T7 

(from link 
byte) 



no 




new 
track 



yes 



new track 

T6 
clear sector 

0->T7 



/ POS \ 



\ Position 
Disk 




Store Sector 
Word Count 



empty\ves 
sector >— — *l 





EOR 



Figure 8-16. LDB - Load CM Buffer 
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Yes 



in CM 
buffer 



Advance IN 
pointer 




No 



Recall CPU 



Process Wrap Around Sector 



Store first 
part of 
sector 



Store 2nd 

part 



Set IN 



WCB 




,VCB4 



Store IN 

into FET 



Update IN, 
Read OUT 



Read OUT 
from FET 




ILDBiJ Loop 



Figure 8-17. WCB - Write Central Buffer 
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/eof) 



EOF/EOI 
FS +4 
(14B) 




Yes 



Yes 



Set next 
track -VT6 
clear sector 
0— >T7 



"KOFl) 




EOF2 



Decrement 
sector count 
PC = PC -1 



LdbxI 




Set EOF 
10— -FS+4 




on EOF^ > yes > [lDBX| 



No 




/^new \ 



No 



\. track yS~ 



L 



Yes 



POS 



\ 



Position 
Disk 



-»|ldbJ 



Figure 8- 18 . EOF - Process EOF 
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Set 

operation 
complete 
in FS +4 





Figure 8-19. EOR - Process Error 




DCH 



Release 
Channel 



Update FST 
Track FS +2 
Sector 

-*~FS +3 




MSP 



Clear 

operation 

complete 

flag 



Figure 8-20. CPR - Complete Read 
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8.5 POSITION MASS STORAGE ROUTINE - PMS 



Figure 8-21 is a partial flowchart of PMS. The Position Mass Storage routine is in over- 
lay 2CF. PMS is called from three places in CIO: 

1. Resident Processor PMS 

2. RMS in 2 CB 

3. WMS in 2 CD. 

PMS - Position Mass Storage (2CF) 

/PMS^ 

PMSA 



PRS 



Preset code 
(set PMSA) 




LJM PMSA 



RRD 


- Process Random Read 


RWT 


- Random Write 


SKF - 


Skip Forward 


SKB - 


Skip Backward 


BKS - 


Backspace 


MSX - 


Rewind 


OPE 


- Open 


CLO 


- Close 



Function Processor Return 
(PMSI 




Current track 

•*- FS +2 
Current 
sector 

FS+3 




Return 
PMSX 



SRA 



set Random 

Address 





Read FET+6 
into DP 



Store 
Random 
Address into 
FET +6 



ves 



Read ZERO 

into 

DP 



Store ZERO 
into FET+6 



■c 



Return 
PMSX 



J 



Figure 8-21. PMS and Function Processor Return 
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8.6 CIO TERMINATION ROUTINES 

Figures 8-22 through 8-24 are flowcharts of the following CIO termination routines: 

UFS - Update File Status 
IOF - Set IN = OUT = FIRST 
CFN - Complete Function 

Entered 

from 
MSP only- 




set file 
status 
complete 
in FS -4 




Set file 
"modified" 



Set "write" 
mode in FS 



Figure 8-22. UFS - Update File Status 
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© 



No 



set file 

status 

complete 

in FS +4 




Yes 



FC = \ No 
REWIND 




Yes 
-MIOF2) 




Set IN = 
OUT = FIRSIt 
in FET 




CFNJ 



Figure 8-23. IOF - Set IN = OUT = FIRST 
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Set file 
not Busy 
inFST 



Set upper 
status to 
previous 
status 



Write 
FST to 
CMR 





clear upper 
status bits 
in FET 




yes 




Set physical 
record count 
in message 
buffer (MB) 



'MONITOR 
Update 
Accounting 



\ UADM 



i 




PPR 



Hence, if FET length <. 5 words, 
1 EOI status is not returned 
in code /status field of FET. 



Figure 8-24. CFN - Complete Function 
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8.7 TERMINAL INPUT/OUTPUT ROUTINE - TIO. 

Figure 8-25 is a flowchart of the terminal INPUT/ OUTPUT routine, TIO. This routine 
is contained in overlay 2CG. TIO is only called from the PFN subroutine. 

8.8 2 CH SUBROUTINES 

Figures 8-26 through 8-28 are flowcarts of the following three subroutines in overlay 
2CH: 

• PMT - Process Mag. Tape Operations 

• MER - Mag. Tape Executive Request 

• UDT - Unit Descriptor Table Read/Write 

Basically, PMT sets up a 3-word parameter block and passes that information to 
MAGNET. The format of the three words is as follows: 



Word 1 



FC 



FC+1 



FC+2 



FC+3 



FC+4 



Function 
code 











MB 



Word 2 



DP 



Request 
code 



12 



DP+1 



DP 42 



DP+3 



DP +4 



FET 
options 



12 



level 



ubc 



^ 



mlrs 



18 



-MB+1 



Word 3 



LM-3 


LM-2 


LM-1 


LM 


LM+1 


Field 
Length 


^ 


FIRST 


^ 


LIMIT 


12 


6 


18 


6 


18 



-MB+2 



where, 

ubc = unused bit count 
mlrs = max. logical record sizei Reference Manual 

Request code is from the FET. The upper bit is 

set if auto- re call was specified. 



7 see FET +6 inK2.1 

i: 



FET options are from byte 1 of FET+1 = EP, UP, xl. 
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Read term. 
I/O control 
word CP+ 
TIOW 



X 



Set OUTPUT 
FET address, 
in ctl. word 



1RO will write output to 
disk on terminal's 
ROL-LOUT me. 





Read INPUT 
control word 
CP + TINW 



Set INPU T 
FET address 
in ctl. word 



Store I/O 
control word 
TIOW/ TINW 



MONITOR 
Rollout con- 
trol point 



ROCM 



Set file 

status 

complete 



CRS 



check for 
recall re- 
quested 



« 

fa 

o< 



£.3 



T3 

> 

I. 

- CD 

01 

0) 

K 



:<N 



O N 

« to 



»S 



0) 



u 

v -a 



V 



a o 



14> 



C 

o 

a 
o 

u 
o 
tl 

0) 



P3 



1- 




DPP 



Set RCL 
with recall 
in RA+1 



Figure 8-25. TIO Terminal Input /Output 
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Read Record/ 
Request, Re- 
turn info, 
(FET+6) 



yes 




Set RCL 
with recall 
in RA+1 




Figure 8-26. PMT - Magnetic Tape Operation 
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Set Request 
code in DP 



Set FET 
options in 

DP +1 




Move FET 
Address to 

IR/IR+1 



Store level 
number in 

DP +2 



c 



Set FIRST 
in LM-1 
and LM-2 



T 



Set FL 
in LM-3 



Write FC 
to MB 



UDT 



Return 




Make 

MAGNET 

Request 



J 



Figure 8-27. MER - Magnetic Tape Executive Request 
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Set UDT 
Address 



Set 
Read/ Write 
flag 



Set 
transfer 
length = 3 




yes 



Figure 8-28. UDT - Unit Descriptor Table Read/ Write 
1* See UNIT DESCIPTOR TABLE in chapter 9. 
8-32 
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RESOURCE CONTROL 



Resource control Involves the allocation of the system magnetic tape and disk pack resources . 
The control of these resources is handled by the system routine (RESEX) , while all magnetic 
tape operations are controlled by the magnetic tape executive, MAGNET. This section 
describes these two executives . 

For a description of magnetic tape formats, consult the KRONOS 2.1 Reference Manual, 
Section 9. Also, Section 5 of the manual contains the control card call, RESOURC, for 
initiating the resource executive, RESEX. 

Figure 9-1 shows an overview of the system routines involved with resource control and 
allocation. 

The whole concept of MAGNET •RESEX is to allow overcommitment of tapes and removable 
packs. 

MAGNET runs at a CP and is a repository of information for RESEX and the System. The 
E,P display is updated by RESEX and displayed by DSD. The E, T display Is the UDTs and is 
updated by MAGNET and displayed by DSD. DSD commands from the console are placed in 
MAGNET and updated by MAGNET. CIO places tape read/write requests in the UDTS. 

MAGNETs main duty is to receive requests from DSD and RESEX and to initiate 1MT to process 
CIO requests . 

RESEX is loaded at a users CP, and the user is saved on a DM* file is necessary. RESEX 
determines the users requirements vs system availability and user validation. Overcommit- 
ment is exercised if necessary. In order for RESEX to determine recource availability and 
overcommitment, all user demand information is save on a Fast Attach PF called RESEXDF, 
all resource activity information Is save on a fast attach PF called RESEXVF . 

In the old days of KRONOS 2.0, tape scheduling was based on tape unit availability . 
For example: assume S tape drives. 

JOB A needs MT2 

JOB B needs MT1 
and JOB C needs MT3 

97404700C 9-1 




wait 



T/-isr> ,..„., i,-i «.»!+ fn* mna ™- Trmn tn rwlaasa a tape so it could continue. 

Now with the advent of KRONOS 2.1, the system can overcome deadlock situations. 

Some definitions are: 

Deadlock - Two or more unsatisfied tape Jobs have tied up all the units in 

the installation. 
Two or more, unsatisfied tape jobs have been assigned tapes in 



Potential Deadlock 



9.0.1 Deadlock Condition 
Assume 8 tape drives . 



such a manner that there are not enough free units remaining to 
satisfy the maximum requirements of any of them. 





MAX 


UNFILLED 


ASSIGNED 


JOBA 


3 


1 


2 


TOBB 


3 


1 


2 


JOBC 


S 


1 


4 - 



None of these jobs is in a 
position to release a drive . 
Hence the Deadlock. 



9.0.2 Deadlock Prevention 





MAX 


UNFILLED 


ASSIGNED 


JOBA 


3 


1 


2 


JOBB 


3 


1 


2 


JOBC 


5 


1 


3 



JOBC requests a tape - Refused since it could cause a Deadlock condition. 

JOBB or JOBA requests a tape - Granted since it would not cause a Deadlock condition. 
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9.0.3 Overcommitment 

Many jobs with tape drives can be scheduled and drives assigned as long as a potential 
deadlock can not occur. As long as at least one job can complete, tapes can be scheduled. 
When at least one job will be unable to complete due to a tape drive assignment, that 
assignment is deferred (i.e. not allowed, even if the operator assigns it). 

9.0.4 Tape Scheduling Deadlock Prevention Algorithm 

The system is "safe" if there exists at least one active job such that: 

a. There are enough currently unassigned tape units to satisfy the maximum requirements 
of the job and 
r*-b. When this job completes, it will release enough tape drives such that the total 

number of drives then available are sufficient to satisfy the maximum tape requirements 
of at least one other job such that ; -j 



9.0.5 Tape Assignment Dynamic Tape Unit Status Checking 
Periodic checking for ready or not ready status . 

• E, T always current! 
Advantages: 

• Automatic assignment can occur at any time. 

• Automatic a signment of unlabelied tapes . 

• Improved reel swapping. 

Tape Assignment Objectives 

• Improve management of tape units 

• Increase automation of tape assignments 

• Flexibility in assignments 

• Assist operator 

• Basis for improvements 

Tape Assignment New Features 

• Automatic tape assignment by VSN 

• VSN control card 

• Tape job prescheduling display 

• Tape drive overcommitment 

• Dynamic unit status checking 
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9.0.6 Tape Preassignment Display 

Resource Mounting Preview 
NO Eg PN/VSN USSRNO FUNG 







•Pipei 


MLC 


T 


31 


MT 


A216B 


AST 




42 


D!3 


CATCH 


FISH 





The following examples will attempt to clarify the KRONOS 2.1 philosophy on OVERCOMMIT- 
MENT of tape/private pack equipment. 

Example 1 shows how deadlock can occur. 

Example 2 shows the classic textbook case o± ovsrcoramitmsnt. 

Example 3 shows a typical overcommitment. 
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Example 1 
Example of DEADLOCK (without RESOURCE protection! 

Assume 4 tapes 



Jobl 
RESOURC(MT = 2) 



Job2 
RESOURC(MT=2) 



MTs Available 



REQUEST(F1,MT) 



REQUEST (F 2, MT) 



RE0UEST(F1 # MT) 



REQUESTS 2, MT) 



1. 


RES0URC(MT=3) 






2. 


REQUEST(F3,MT) 




-1 


3. 




RESOURC(MT=3) 




4. 




R£QUEST(F3,MT) 


•2 
DEADLOCK 



1 . If Jobl is not aborted then: 

2. Jobl rolled out since no tapes are left to assign. 

3. Job2 rolled out since no tapes are left to assign. 

4. Neither job can complete and neither job can release any tapes, 

so both Jobs and the tape system are locked up tight==DEADLOCKED. 

Hence, at point 1. Jobl is aborted since the resources desired are not currently 
available. However, Job2 is not aborted, since when Jobl was aborted it released 
its two tapes. So, Job2 resources are available. 
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Example 2 
Assume System has 4 MTS Available 



Job 1 

JOB 1 
ACCOUNT 
RESOURC (MT=3) 
REQUEST {Fl, MT)* 



REQUEST (F2, MT}» 



REQUEST (F3, MT)« 
I 



lob 2 

JOB 2 
ACCOUNT 
RESOURC (MT=3) 



MTS Available 

4 
4 

4 



REQUEST (Fl, MTJ» 1 

REQUEST (F2,MT) |RO 1 



RETURN (F2)* 

decrenment demand 

count by 1.0 REQUEST (F2,MT)*— ' 



END - OF - JOB 



RI 



END - OF - JOB 



* REQUEST PROCESSED WHEN ENCOUNTERED 

Note that UNLOAD will return a tape without 
decrementing the demand count. 

If this Job 1 attempts another request, it will be aborted. 
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Example 3 
Assume System has 3 MTs Available 



JOB! J0B2 

JOB1- JOB2. 

ACCOUNT, , . ACCOUNT, , . 

RESOURC(MT=3)* RES0URC(MT=1) 



REQ 
REQUE! 



UEST(F1,MT)* 
ST(F2,MT)* 



REQUEST(F1,MT)* 



REQUEST(F3,MT)RO-, 



ROLLED 
OUT 



* 



R}-^ 



RETURN (Fl) 



REQUEST<F3,MT)* 



ROLLED 
IN 



END -OF -JOB 



RETURN (F2)* 



decrements 
demand 
count by 1 . 



REQUEST(F4,MT) ABORT 
"DEMAND EXVEEDED" 
END-OF-JOB 



JOB 3 


MTs available 


JOB3. 




ACCOUNT,,. 


3 


RESOURC(MT=2)* 


3 



REQUEST(Fl,MT)RO-, 



ROLLED 
OUT 



! 



RW 



REQUEST(F1,MT)* 

ROLLED 
IN 



REQUEST(F2,MT)* 



END-OF-JOB 



2 
1 

•REQUEST PROCESSED 
WHEN ENCOUNTERED 
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The following synopsis shows the interaction for Tape Scheduling 

1 . without VSN 

2. with VSN 

3. private pack scheduling. 

Tape Scheduling Without VSN 
User System 



Operator 



Attempt to access 
file on tape via 
REQUEST LABEL. 



entered at entry 
point LABEL or 
REQUEST (as a CC 
call , i . e . not an 
SPCW call) . 

3„ RESEX uses the macro 
which makes an 
RA + 1 request for 
LFM, 

4. LFM issues the 
REQUEST B-display 
message and waits for 
the operator to assign 
equipment. The control 
point may be rolled out. 



5. Operator scans E,T 
display for a free drive, 
mounts the tape and 
assigns the equipment 
to the control point. 



LFM reads equipment from 
CPA, OAEW ward, and saves 
it in an FNT/FST entry. 
Then LFM calls RESEX via 
SPCW word in CPA and 
drops . (Original RESEX 
is saved on DM* file) . 
The equipment number is 
passed in the Status field 
of the SPCW. 
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User 



Tape Scheduling Without VSN (Continued) 

System Operator 

7. RESEX reads the UDT 
entry associated with 
the eq in MAGNET'S fl 
(via RSB) , sets up a 
request block and sends 
it to MAGNET (RCAL 
block via SIC) . 

8. MAGNET assigns the UDT 
to the job and completes 
the request, (sets up 
the rest of the UDT 
entries) . 

9 . RESEX reads the UDT 
entry again and when 
complete, calls LFM to 
complete the FNT/FST 
with the UDT address, 
updates the E, P (preview 
buffer) and ends. 

10. The original REXEX is 
rolled back in from DM*,- 
updates the E,P and ends. 

1 1 . Control point is 
advanced. 



User 

Attempt to access 
file on tape with 
REQUEST (VSN=...) 
LABEL (VSN=...) 
VSN 



Tape Scheduling With VSN 

System 



Operator 



RESEX is loaded as a CC call 
and is entered at appropriate 
entry point. 

Parameters are processed and 
LFM is called to create 
FNT/FST entry with eq type 
TE if not already present. 
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User 



Tape Scheduling With VSN (Continued) 

Svstem Operator 

4. RESEX reads all UDTs, via 
RS8, and looks for a match 
on VSN. 

5a. If duplicate USN's are found 
LFM is called to have 
operator assignment. 



5a. Operator scans E,T and 
assigns tape. 



Sb. If VSN is not found, RESEX 
sends preview information to 
MAGNET and calls LFM to 
enter Timed/Event rollout 
(the time Interval is 2 minutes 
and the event is a folded 
checksum of the VSN) . 



Sc. RESEX finds single VSN. 



Sb. Operator scans E,P and 

mounts tape with proper VSN , 



6c. No operator Intervention 
necessary. 
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7. RESEX sets up a request 
block and sends it to 
MAGNET (SIC to RCAL) . 

8. MAGNET assigns the UDT to 
the job and completes the 
request (sets up the rest of 
the TOT entries) . 

9. RESEX reads up the UDT's and 
finds the tape assigned to a 
TOT and calls LFM. 

10. LFM completes the FNT/FST 
and changes assignment from 
TE to proper MT or NT, (est ord) 
and ends. 

11. RESEX updates the E,P display 
(Preview Buffer) and ends. 

12. Control Point advances. 

97404700C 



User 



Automatic Scheduling of Auxiliary Packs 

System Operator 



Attempt to access 
file on aux. device 
ATTACH (A/PN=PACK,NA) 



2 . PFM called and detects 

a. "PACK" not present 

b. User requests wait 
(NA) — 



(NO ABORT) 



3. 



PFM requests RESEX 
processing 

RESEX after determining if 
request can be honored enters 
data in Preview buffer 
(MAGNET) and rolls out for 
2 minutes. 



7 . Every 1 minute CMS will 
status drives - if "PACK" 
is available it will be 
"recovered" and set as 
available in MST. 

8 . RESEX rolled out. will roll 
in every 2 minutes and 
interrogate to see if 
"PACK" is available. 

9 . If it is , resource files 
updated and PFM is recalled 
to process ATTACH function 
and control then returned 

to user. 



Operator scans E, P 
display and notes name 
and type of pack required. 

Operator scans E, M 
display and then mounts 
pack on available spindle 
(must be removable 
equiDment) 
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Automatic Scheduling of Auxiliary Packs (Continued) 
User System Operator 



10. UserRETOTNS 
file A 



1 1 . System updates appropriate 
tables , MST to indicate 
device is no longer being 
used (user count} . 



12. Operator via E, M display 
notes that PACK has no 
active use. 

13. O n srator enters UNLOAD 
This prevents further PF 
requests to PACK. 

14. Operator removes pack . 



1 5 . CMS on next cycle 

recognizes that device 
is not ready and "dears" 
MST accordlnaly. 
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LABEL ^ 
ASSIGN 
REQUEST >- 
VSN 
RESOURC / 



RESEX 



{REQ) 



MAGNET 




USER 
JOB 





PREVIEW 
DISPLAY 



(UNLOAD 

\vsn 




Figure 9-1. RESEX/ MAGNET System Interface 
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3MK - READ error processor 

wa»j-j_i niuiJJ 1LU1\<UUU ^U^COAUl 

3MM - Write long block processor 

3MN - Coded WRITE processor 

3MO - Write label processor 

3MP - WRITE error processor 

1LT - Long block processor 

1MT overlays itself extensively to conserve space. It uses areas in PP Resident and the 
5-byte header on PP routines, therefore due care must be taken when attempting mod- 
ifications . 

All magnetic tape equivalences are defined in the common deck, COMSMTX. These 
equivalences are used by MAGNET, RESEX, 1MT, CIO, DSD, ORF, and IDS. 

9.1.1 MAGNET Control Point Initialization/ Termination 

The control point for MAGNET is initialized in the same manner as TELEX or TRANEX. 
That is, DSD calls IDS to process the operator type-in, MAGNET. IDS then calls 
1MT to initialize the executive. 1MT determines that this is an initial call to MAGNET and 
executes overlay 3MA to perform control point initialization. (1MT determines that this 
is an initial call by checking for "MA" in word JNMW of the control point area). 3MA per- 
forms the following operations: 

1. Calls INI to store jobname of "MAGNET" in control point area with system 
origin type (SYOT) set. Calls monitor to set priority =76. 

2. Calls RQS to request field length. 

3. Calls SCC to set up the control card buffer as follows: 

MAGNET 
MAGNET1 
EXIT. 
MAGNET 1. 

4. Calls EST to preprocess EST entries. A list of tape channels and equipments 
is created in PP memory. 

5. Calls PCC to call 1AJ to process the first control card. (MAGNET loaded by 
1AJ. ) 

6. MAGNET is loaded in the CP. 

7. Calls BDW to build an equipment definition list in MAGNET'S FLatRA+ UINT = 7700B. 
Only used during initialization to build UDTs, following PRESET code in MAGNET. 

8. Calls BIW to build interlock words in MAGNET'S FL at RA+UITW (RA+10B). 
These words are used by MAGNET to call and interlock with 1MT. (An entry 
is passed to 1MT via a TLX call in RA+1. ) 

9. Sets an inter-control point word in CP area as follows: 
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59 




48 


47 




30 


29 


18 


17 







RCALL 


RCAL 


PBUFL 


PBUF 



where : 



12 

RCALL 
RCAL 
PBUFL 
PBUF 



18 



12 



18 



10. 



PREVIEW display) 
Drops 1MT. MAGNET is now in control. 



Length of RCAL (10B) 

RESEX request block buffer 

Length of PBUF 

FWA of preview buffer (read by DSD to build 



9.1.2 MA GNE T Initialization 

After Step 6 of paragraph 9. 1. 1 is completed, 1AJ loads the CP portion of the executive 
MAGNET, and execution begins at the preset routine, PRS. PRS clears the interface 
area from UITW+1 through TRPO (RA + 11B - RA +140B). The interlock word UITW 
is cleared and MAGNET waits until step 7 is nearly complete before continuing processing. 
That is, MAGNET waits for 1MT to build the equipment definition list. PRS then calls 
PEQ and REL before jumping into the main control loop. PEQ builds a list of UDTs 
(one for each unit as sensed by 1MT). REL performs the required instruction modification 
in the main routine where the OPDEF's have been used. The UDTs start at TDTAB and 
overlay the preset code. A maximum of 16D (MUNIT in COMSMTX) UDTs are established 
in MAGNET'S FL. PEQ also sets up a pointer word in RA+3, called UBUF, which points 
to the list of UDT entries. UBUF has the following format: 



RA+3 



UBUF 



Number of 

Units 


LWA of UDT 


FWA of UDT 



12 



24 



24 



where: FWA of UDT = TDTAB = 767B currently 

LWA of UDT - Dependent on number of units 

Each UDT entry is UNITL words long (currently, UNITL = 20D) . PEQ sets the SED 
function (Set Equipment Definition) in each UDT entry, therefore 1MT will be called 
to determine the type of each unit. 

PEQ sets up another low core pointer, UQUE. UQUE (RA+4) specifies the first word 
address of the queue table. This table follows the UDT list, and is initialized with 10B 
empty entries. The queue table is terminated with two words of all 7's. The Last Word 
Address (LWA) of the queue table is stored in FLSW+1, currently RA+30B. FLSW contains 
the starting FL from A0. Figure 9-2 is provided to show the memory map of MAGNET 
after initialization. The PREVIEW buffer (PBUF) is built by RESEX and transmitted 
to MAGNET where DSD obtains information to be displayed. 



9-4 



97404700B 



47 



21 



RA + 
1 
2 
3 

4 
5 
5 
7 

10 

20 
2i 
22 
23 



34 
35 

44 
45 

143 
144 

1060 



# of entries 



LWA of UDT 



FWA of UDT 



FWA of Queue 



unit swap flow 



Two word 



DSD request buffer 



1 MT 



interlock words 



40000000000000000000 



Field Length status word 



1 MT function codes 



UBUF 
UQUE 
USWP 
XEEQ 

UITW 



Terminated by 
Two words of bit 
59 set 

FLSW 
TFUN 



4 00000000000 0000000 terminator 



RESEX request block Buffer 
used by RESEX to request 
UDT assignment to Tape 



RCAL 



E, P Preview buffer data 



Code 



UDT, 22D words per UDT 
1 UDT per Tape drive 

40000000000000000000 



77777777777777777777 



77777777777777777777 



PBUF 



TPRO 



TOTAB 



terminator 
Queue table 
10 empty 
entries initially 
two word of all 
7 terminates table 



Figure 9-2. MAGNET Memory Map (Level 5) 
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J 



RECIO 



WC 



address for 1st UDT 
in example gg 

1360 UXRO 

1361 UCIA 

1362 UCIB 

1363 UCIC 

1364 UST1 

1365 UST2 

1366 UST3 

1367 UST4 

1370 UST5 

1371 UST6 

1372 ULRQ 

1373 UREQ 

1374 UFLA 

1375 UFSQ 

1376 UJBN 

1377 UUFN 

1400 USVN 

1401 UFID 

1402 UFSD 

1403 USID 

1404 VGNU 

1405 UDAT 



47 



35 



23 



RS 



ICIO 



FL 



ED 



FUNCTION 



MODE(MD) 



PA 



SKIP COUNT 



FET OPS 



LNU 



PB 



FET ADDRESS 



Record Request Return 



FIRST 



HP 



Disk PRUs 



Last GOOD Record 



OV 



UBC 



EC 



LIMIT 



BLOCK count 



Error Parameter 



FORMAT 



EST 



NB 



DS 



User OPS 



Den 



CV 



SP 



MTS detailed Status 



MTS Status continued 



MTS Format 



MAGNET Last Request 



20NN 



ADD 



B2 



B3 



X5 



MAGNET flags 



Job Seq Num 



CP NUM 



SIND 



Jobname 



User Number 



VSN Rand Index 



OT 



FAM 



ESW 



Accv 



Volumn Serial Number (VSN) 



3 word 
block 
sent by 
CIC 



66X 
words 



FILE Identifier 



FILE Id continued 



SET Id 



Creation Date 



Acch 



GEN VER 



File Section Num 



File Seq Num 



GEN Num 



Expiration Date 



22D = 26B words per entry 

Description contained in COMSMTX. 
A partial listing follows . 



Figure 9-3. Unit Descriptor Table (UDT) Entry (Level 5) 
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assembly constants. 



20 


MUNIT 


POM 


iOQ 


RO*L 


EOU 


r^go 


UIMT 


EOU 



160 M4XIMUM NUMBER OF UNITS 

100 INITILI7ATION PIELO LENGTH 

R1FLM0O-1O0 INTTLI7ATI0N INTERFACE ARE4 



UNIT ^FSCPIPTOR TAALE POINTERS. 





IOC 


1 


i UXRO 


BSS 


t p°U EXECUTIVE REOUEST 


1 UCIfl 


R-SS 


1 CIO RFOUEST 


i ucib 


!3SS 


L CIO REOU^ST 


1 UCTC 


P-SS 


L CIO REQUEST 


i USTl 


RSS 


L STATUS (1> 


1 UST? 


BSS 


I STATUS (?) 


i 'jsn 


«ss 


1 STATUS 131 


i USTfc 


<3SS 


t STATUS (CPU) 


1 UST5 


5SS 


L MTS OFTAILEO STATUS 


1 UST6 


gss 


I ITS 3ET4TLEO STATUS AMI FORMAT 


1 ULRO 


RSS 


L LAST RFOUFST POINTED 


1 UR c O 


RSS ! 


REQUEST POINTER WORD (INTERNAL) 


1 UFL 4 


RSS 


FLA'"- WORT 


1 UJSO 


PSS 1 


JOB SEQUENCE NUMBER, C° NUMBER, VSN IMFO 


1 UJRN 


BSS 


L UNIT JOB ASSIGNMENT INFORMATION 


t UUFN 


R-SS 1 


USER NUMBER, FAMILY NAME. (TA»E OWNERSHIP! 


1 UVSN 


ass i 


VOLUME SEPIAL NUMBER 


1 UFTO 


RSS 1 


FILE TDENTTC4TICN 


1 UFSN 


bss i 


FILE S^CTTON NUMBER 


1 USIO 


R-ss 


SET IDENTIFIER 


1 UGNU 


SSS 1 


GEM c RATTON INFORMATION 


1 UOAT 


RSS 1 


DATE INFORMATION 


1 'JNITL 


BSS J 


LENGTM C INOIVIOUAt UDT 




LOC ' 






UUtlTL 



EOU 



!)OAT»l-UUFM LE5NT OF UDT CONTAINING LABEL INFORMATION 



Figure 9-3. Unit Descriptor Table (UDT) Entry (Level 5) (Continued) 
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UMTT T^fPieTOS TA^LE DOCUMENTATION. 

17/ PS,!?/ FUNCTION, 1?/ MODE.1?/ °A,12/ PT 

1?/ iriO,?t»/ SKIP COUNT, ?<»/ FFT ADORFSS 

l/R,l/D,l/,B/ECTO,12/ p OP«l.<,/LNUM.2/,30/ "FCOPO REOUEST RET. 

12/ FL,?l»/ FIRST, ZUt LIMIT 

1?/ Fn,i?/ MP.iz/ EC, 13/ ES,1?/ OS 

?«»/ HIS* PRUS,?<»/ 3LOCK COUNT, 1?/ USEP OP? 

?<•/ LftST GOOO PEC0RD,2"t/ ERPOP PARAMETER. 6/ DEN, 6/ CV 

1?/ WC,6/OV,6/ UBC12/ FORMAT,*/ EST, 6/ NB.12/ SP 

60/ *TS DETAILED STATUS 

36/ MTS DETAILED STATUS, *l»/MTS e ORMAT 

60/ HftRNET LOST PEOUEST 

1?/ 25NN.12/ ADD, 6/ >>2,12/ 33, 1«/ X5 

60/ MAGNET FLAGS 

2U/ JO" SEQUENCE NUMBER, l'/CP NUMBER. 5/, 18/VSN RANDOM INDEX 
1,2/ J0RNAM£,6/ 0T.12/ 

d?/ USER NUMBER, 6/ FAM,6/ ES«,6/ ACCV 
36/ VOLUME SERIAL NUMBER, 12/ FLAGS, 12/ 
60/ FJLE IDENTIFIER 

«/ FILE TOENTIFIFR CONT..1S/ FILE SECTION NUM 
36/ SET IDENTIFIER,*/ ACCw,l°/ FILE SETUENCE NUM. 
30/, 12/ GEN VER,1»/ GENERATIO* NUM 
30/ CPEATION DATE, 30/ EXPIRATION DATE. 

DIRECT CELL ALLOCATION RELATIVE TO UOT. 

12/ RS,12/ C N,12/ MD,12/ PA, 12/ PB 

12/ En,i?/ hp, 12/ EC, 12/ ES.l?/ OS 

24/ D° - DP+1,2^/ PL - BL*1,12/ UP 

2<»/ LG - LG*1,24/ EP - EP*1.12/ DC 

12/ HC,6/ 0V,6/ UB,12/ F«,6/ E0,6/ N9.12/ SP 
* 
• PS SEE COMPLETION CODES. 

» FN SEE FUNCTION NUMBERS. 

* 



•T 


UXRO 


•T, 


UCIA 


•T, 


UCIB 


»T, 


UCIC 


•T, 


UST1 


•T, 


U3T? 


•T, 


UST3 


•T, 


USTi. 


•T, 


UST5 


•T, 


UST6 


*T, 


UL°0 


•T, 


URSQ 


•T, 


UFLA 


*T, 


UJST 


»T, 


UJRN 


•T, 


UU C N 


•T, 


UVSN 


•T, 


UFID 


»T, 


UFSN 


•T, 


usm 


•T, 


VGNU 


♦T, 


UOAT 



*T 


UXRD 


•T, 


USTI 


•T, 


UST2 


»T, 


UST3 


•T, 


usn 



MO 


MODES. 





NONE. 


1 


READ SKIP. 


2,3 


- ppu OPERATION. 




1 - EOR OPERATION. 




2 - EOF OPERATION. 


3 


EOT OPERATION. 


i> 


260/26«f CONTROL WORD. 


5 


200/?0<t CONTROL WORD. 



Figure 9-3. Unit Descriptor Table (UDT) Entry (Level 5) (Continued) 
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COMPASS 3.7i>16>>, 



rMhH 



15. lU.S'i.M. 



'AGE 



6 COOED. 

10 EQR/EQF THIS OPERATION. 

13 SET IN = OUT = PT9ST. 

1? 'EVE'S? (READ LABELS ONLY) 

13 REVERSE (PE»0 DATA! 

PA, PP. SEE INOIVOUAL FUNCTIONS. 

UCIA- UCIC INFORMATION »&SSED BY 110, 



icio 

9 


ECIO 
FOPS 
LNU" 
FL 

en 



wo 


1 
? 

3 
b 

5 

11 
1? 
13 



Hi 3 -01 AMD 



EC 
ES 

OS 



(jo 


1? 

13 

rp 
OC 



INTERNAL CIO CODE. 
SFT I<? AUTO RECALL. 
SET IF DATS IN BUFFER. 
USER CIO REQUEST CODE. 
USER.S Fc T OPTIONS. 
LEVEL NUMBFR. 
JOB FIELD LENGTH. 

EO'JIomfnT CONNECT CODE (TITS IT ■ 
CHANNEL OESIGNATOP (BITS 10 - <*i 

HARDWARE 0°TIONS. 
B TRACK UNIT. 
STATUS ? AVAILABLE. 
CONVEPSION MOOF. 
CONTROLLED BACKSPACE. 
PROGRAMMABLE CLIP. 
MTS CONTROLLER. 
BLANK TA°E. 
LAST BLOCK EOR/EOF. 
LAST OPERATION W'TTE. 



SEE ERROR COOES. 

HARDWARE STATUS ?. (EXTFNOFO STATUS.) 
OPTGINAL OFVTCE STATUS FOR MTS. 

OFVICE STATUS. 

FOP MTS. OFVTCE STATUS CONVERTED TD 3000 FORMAT. 

USER OPTIONS. 

CODED. 

NOH STANOAPO LABELS. 

LABELED 

FRPOR FARAMTFPS (SEE FRPQR PROCESSORS FOR USES.) 



DENSITY AND CONVERSION MOOE. 
13-6 DENSITY. 
5-3 CONVERSION MODE. 

LG LAST GOOD BLOCK CHECKSUM PREVIOUS BLOC*. 
LR»1 LAST GOOD PLOCK CHECKSUM CURRENT BLOCK. 

SEE ROUTINE CKS IN WRITE FQR CHECKSUM METHOD. 



HC 



"LOCK WORD COUNT. (0 .LE. WC 



100021 



COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 
COMSMTX 



Figure 9-3. Unit Descriptor Table (UDT) Entry (Level S) (Continued) 
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COMPASS 3.7<.16». 



74/10/15. 1<».5R.16. 
COMSmTX 



PAGE 



OV OVERFLOW BLACK COUNT. <«f0008 BYTE BLOCKS) 

UB UNUSED BIT CCUNT, 

FH SEE FORMATS. 

EO EQUIPMENT WRITTEN ON. 

NB NOISE P-YTE DEFINITION. 

5 FILL OKAY. 

1* - NUMBER OF BYTES OF NOISE. 



SP SOFTWARE OPTIOKS. 

ABORT RPE/WOf WITH E c SET. 

1 ACEPT OATA ON RPF/WRE WITHOUT EP SET. 
Z INHIBIT ERROR «?0CESSTNG. 

T RING IN REOUIRED. 

1, RING OUT REOUIREO. 

5 INHIBIT UNLOAO. 

13 - 1? END OF PEEL. 

C - READ TO TAPE MARK FOLLOWED BY LA9EL 

OR AFTER EOT ON UNLABLEED. 

1 - ACCEPT BLOCK OF DATA EOF OCCURFO ON. 

?. DISCARD BLOCK EOT OCCUREO ON. 



FLAGS LABEL PROCESSING FLAG?. 

C REMOUNT TAPE FLAG. 

11 FILE OPENED SINCE ASSIGNMENT. 

12 SCATCH VSN. 

13 LABEL CHECKING IN PROGRESS. 



COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSHTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 

COMSMTX 



Figure 9-3. Unit Descriptor Table (UDT) Entry (Level 5) (Continued) 
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Note: Words UCLA, UCIB, and UCIC are set up by CIO for MAGNET to process tape 

I/O requests. The three words are passed to MAGNET by CIO's issuing the TDAM 
monitor function. The three -words are transferred by monitor into the UDT entry 
specified in the FST entry for the file. 

9.1.3 MAGNET - Run-time Executive 

Figure 9-4 shows a more detailed outline of the executive code referred to in Figure 9-2. 
TPRO is a table of processor strings. Each entry is generated at assembly time by the 
PROC macro which results in a string of processor entry point addresses and/or functions 
to be processed for a particular request. Part of the TPRO list is indexed by the internal 
function codes defined in COMSCIO. Thus, any change to COMSCIO may require changes 
in TPRO. 



Ail ICliS bll . 



JLa.cn ciiLi.y liicL v diau uuuiciiii 



parameters within the string. Up to three 12-bit parameters can be imbedded in a string, 
but, if less than three are given, the rest are assumed to be zero. A parameter is 
differentiated from a processor or function by setting bit 11. The three parameters, 
if specified in a particular string, are referred to as MD, PB, and PA, respectively. 
These parameters are referenced throughout the listing and in word UXRQ of the UDT 
entry described in Figure 9-3. 

Figure 9-5 shows the relationships between the various subroutines within MAGNET. 
According to the diagram, MAG calls the major subroutines: CUT, CXR, ASU, and PPU. 
CUT checks all UDT entries for outstanding requests from CIO. The queue table is also 
searched for any outstanding requests, and, if any are found, they are processed. CXR is 
called to check for external requests from DSD. CXR will call MQE to make queue entries 
for certain requests. ASU is called to perform unit assignment as requested by RESEX. 
Finally, PPU is called to activate 1MT if a PP is available. Table 9-1 is a list of the 
functions issued to 1MT by MAGNET. 



TABLE 9-1. MAGNET FUNCTIONS TO 1MT 


Function Name 


Value 


Meaning 


SED 


1 


Set Equipment Definition 


CUF 


2 


Complete User FET 


MAB 


3 


Issue message and abort job 


FNH 


4 


Process function (hardware) 


PIO 


5 


Process Interlocked Operation 


SKP 


6 


SKIP 


RDF 


7 


Read data 


RLA 


10 


Read label 


WTF 


11 


Write data 


WLA 


12 


Write label 
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IFKU " 


TABLE OF PROCESSOR STRINGS 


MAG ~ — 




MAIN PROGRAM 


PPU 




CALL.EaOCESSORS.AS.MEEKEB 


APP 




ASSIGN PPU 


ASU~' 




ASSIGN UNIT 


CXR 




CHECK FOR EXTERNAL REQUESTS 


CUT 




CHECK JIDT.EQBJMaUESia - 

COMMON EXIT POINTS 


EXI 






REQUEST PROCESSORS 




SUBROUTINES 



Figure 9-4. Outline of MAGNET Code 




SBS 
GPI 
MQE 
GNR 



REQUEST 
PROCESSORS 



Figure 9-5. MAGNET Subroutine Relationships 
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These function codes are stored in the first word (UXRQ) of a UDT entry by MAGNET 
prior to calling 1MT. In the same word, 1MT returns the completion codes in Table 9-2. 

TABLE 9-2. 1MT COMPLETION CODES 



Cods £?stms 


Value 


Meaning 


RIP 
NCP 
REQ 
ERR 


1 
2 
3 

4 


Request in Progress 
Normal Completion 
Re -queue with delay 
Error Return 



The MAGNET/ 1MT interlock words are initialized by 1MT and are used by MAGNET to 
call 1MT. The call to 1MT is via a TLX request in RA+1. The format of an interlock 
word (UITW) is as follows: 



1MT 



18 



CH 



12 



EN 



12 



MT 



12 



where: 

CH 



EN 
MT 



bits 

0-4 
5 

6 

7-8 

9-11 



meaning 

Channel number 

set if 6684 is on channel 

set if only one channel access 

zero 

processor number (0-7) used by 1MT 

to index into UITW 



Equipment number 

Conversion memory type. The upper bit (11) is set by MAGNET 
to indicate to 1MT that conversion memory must be loaded. 



9. 1.4 1MT - PP Magnetic Tape Executive 

In general, 1MT searches through the entire UDT to process requests for each unit. 

As requests are honored, a return code is placed into the first word of each UDT entry. 

A request is picked up from the first word of the UDT entry and used to scan a table of 

function code processors. The appropriate overlay is loaded and executed to perform 

the requested function. Table 9-3 shows which overlay is required to perform the requested 

function. 
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TABLE 9-3. FUNCTION OVERLAY 



Function 


Overlay 


SED 


3ME 


CUF 


3 ME 


MAB 


3ME 


FNH 


3ME 


PIO 


3ME 


SKP 


3MF 


RDF 


3MF 


RLA 


3MF 


WTF 


3ML 


WLA 


3ML 



9.2 RESEX - RESOURCE EXECUTIVE 

RESEX controls the requests for magnetic tape and removable disk pack resources. 
The following tape-related control cards are processed: 

ASSIGNGEQ. LFN. PI. P2 PN) 

LABEL(LFN,P1,P2 PN) 

REQUEST(LFN,P1,P2, . ...PN) 
VSN(LFN=VSN1/VSN2=VSN3) 

The following control card establishes the maximum number of tape and pack units that 
will be in use concurrently while the job is running: 

RESOURC(RTl=Nl,RT2=N2, ...,RTN=NN) 

An explanation of the control card parameters is available in Section 5 of the KRONOS 
2 . 1 Reference Manual . 

The above control cards (except RESOURC) are available to the user via macro calls. 
Thus, any job that uses one of the above control cards or macros will initiate a call 
to RESEX at that job's control point. To avoid destroying the user's field length when 
RESEX is invoked from a macro call, the special entry point DMP= is defined in RESEX 
at assembly time. This entry point is used to flag 1AJ to call 1RO prior to loading the 
RESEX binaries at the control point. 1RO rolls the user's job to a disk file named DM* 
This procedure is described in Section 5 of this manual. Other special entry points defined 
by RESEX are: 

ARG= Suppress 1AJ argument processing 

RFL= Defines RESEX's field length 

SSJ= Declare RESEX to be a special system job 
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To aid in the allocation of pack and tape resources, RESEX updates two disk files. The 
two files are known as the resource files and are "fast attach" type direct access permanent 
files. These files are initialized by ISF under the system user index and assigned the 
names RESEXDF and RESEXVF. RESEXDF is the resource demand file and contains the 
maximum concurrent demand for each system resource type. It also contains information 
for the PREVIEW display and the SHARE table. RESEXVF is the VSN file and contains 
volume serial numbers associated with a particular job. It also contains a random index 
to an associated entry in RESEXDF. Entries in the two files are associated with a particular 
user job and identified by the job's sequence number. Entries in both files are one PRU in 
length (84D words). Additionally, these two files are updated by the PP routine ORF. 
This routine will update a demand file entry or clear entries from either file. It is called 
at job completion time by 1CJ and by 1TA, REC, and ODF. 1TA calls ORF at logout time 
(for a time- sharing job) to remove a demand file entry for that job. 

Entry formats for these two files are defined in common deck, COMSRSX, and are given 

in nguix j-u cluu &- i . 

Other tables built by RESEX are RET, EVSB, RQ and RDT. 

• Resource Equipment Table (RET) 

The resource equipment table consists of a combination of data collected 
from the EST, MST, and UDT tables. It contains one word entries and is 
the same length as the EST. The format of an RET entry is as follows: 



59 48 


47 






36 35 






24 23 


12 


11 





DT 





CU 





OU 


EQ 


NE 


EI 


flags 



12 



12 



12 



where : 



DT 

CU 

OU 

EQ 

NE 

EI 

flags 



Device type from EST entry 

Current number of units in chain 

Original number of units in chain 

Equipment number (EST ordinal) 

Pointer to EST entry of next pack in chain 

EVSB index +2 (if any) 

as follows: 



bit 


1 
2 
3-10 

11 



meaning 

unit logically assigned 

not used 

end of chain of packs 

not used 

checking labels being done by MAGNET 
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RJSQ 


Job Sequence Number (24-Bits) 




1 




RJBN 


Job Name 




RVAL i 


# of Tapes 


# of Packs ' unused 


2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

-77 

r 




RMTP 


MT 





Not Used ! Unused 


Assigned i Demand 


Seven track 




NT 















! 




Nine track 


RRPP 


DAI 


















6603 




DB1 


















6638 


This table 
is set up 
at D/S 
time only 
entries 
needed 
exist 
other 
entries 
are zero. 


DC1 


















863 


DEI 


















ECS 


DF1 


















813/814 


DH1 


















821 


"DPI 


















DDP 


DD1 


















854-1 


DD2 


















854-2 


DD3 


















854-3 


DD4 


















854-4 


DI1 


















844-1 


DI2 


















844-2 




DI3 


















844-3 




DI4 


















844-4 




DI5 


















844-5 




DI6 


















844-6 




DI7 


















844-7 




DI8 


















844-8 




MD1 


















841-1 




MD2 


















841-2 




MD3 


















841-3 




MD4 


















841-4 




MD5 
















841-5 




MD6 












i 




841-6 




MD7 












i 


841-7 




MD8 


"\ 


f 


1 


1 






841-8 


1 RQPD 


VSN or Packname Display Cooe 


MT. DU.etc. 


Preview Data 


1 R ° PU 


User Number 


Flaas . 1 FST address 




1 RQPT 





Time 




1 RRPS 


Packname ... • 


Index 1 Eauio 


> Share Table 


r 
* 


• • 

r • 1 




Figure £ 


i-6. 


Dems 


md F 


il 


e£ 


ntry (] 


SESEX 


DF) 









•where: 



RVAL - Contains the validation limits (that is, the 

number of pack and tape allowed to be assigned 
to this user) . From APUS in control point area. 

RMTP - Two words for seven and nine track tape parameters . 

RRPP - 27 words of removable pack parameters (left hand 
18 -bits are in display code. 

RRPS - Share table is a list of removable packs 
assigned to the job. 



I 1 sector per user requesting allocatable devices. 
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VJSQ 
VJBN 

VLFN 
VDFI 

VVSN 



36 35 24,23 18 


17 6 


5 


24 Bits 
JOB SEQUENCE 


UNUSED 


JOBNAME 


UNUSED 


LOGICAL FILE NAME 


UNUSED 


UNUSED 


DEMAND FILE 
INDEX 


VOLUME SERIAL NUMBER 


UNUSED 


CN 


• 
• 

• 


• 
• 



>VSNL = 100B 



77 



where* 



CN - Control byte as follows: 

Value Meaning 



/ 



Multi-reel 
Alternate reel 
End of entries 



Figure 9-7. VSN File Entrv (RESEXVF) 
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Environment VSN Buffer (EVSB) 

The environment VSN buffer contains data relating to mounted magnetic 
tapes and removable packs. An EVSB entry is two words of the following 
format: 





48 47 36 


35 24 23 


18 


17 


VSN 


RI 


EQ - 


flags 


Sharers 


UDT/MST 


Sequence Number 



12 



12 



24 



where: 

RI — Resource index; points to a word in the demand 
file entry between RMTP and RQPD. 

EQ — Equipment number 

flags as follows: 



bit 

53 

52 
51 
48-50 

Sharers — 

UDT/MST - 



meaning 

assigned 
scratch VSN 
counted 
not used 

Number of users sharing pack 
UDT address if tape or 
MST address/ 10B if disk 



Request Block (RQ) 



36 35 



18 17 12 11 6 5 



RQ 
RI 
RU 
RS 

where: 
RT 



VSN or PACKNAME 


RT 





RI 


User Job Name 


JO 





SN 












Resource Type (left justified in the 18-bit field). 
Values for RT are MT, NT, DAI, DB1, etc. as in the 
demand file entry on page 

RI — Index into demand file entry 

JO — Job origin type 

SN — Job sequence number 
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Resources Demanded Table (RDT) 







42 41 










12 


11 







RT 





F 


OE 


TT1 




E3 


E4 


S5 


T7I /> 


in n 
XL* ; 


E8 





6 


6 


6 


6 


6 


6 


s 


6 




12 







where : 

RT - Resource Type 

F - Flags 

OE — Original Equipment 

E1-E8 — equipments being demanded from demand file 
entry in RE SB buffer 

An outline of the subroutines contained in RESEX follows: 

• FET's for: 

- Requested file 

- VSN Entry file (VFILE) 

- Resource Demand file (RESEXDF) 

- VSNFILE (RESEXVF) 

- Two scratch files 

• SSJ parameter area 

• Control point area parameters 

• Temporary storage 

• Control card processors: 

- ASSIGN 

- LABEL 

- REQUEST 

- RESOURC 

- VSN 

• External request processors: 

- LFM 

- PFM 

- REQ (SCOPE type) 

• Resource request Block (RQ) 

• Overcommitment Algorithm Control Routine (COMMIT) 
and subroutines: 

- BRE - Build resource environment 

- BSF - Build scratch file 

- CFU - Check For unit 

- CR C - Check requester complete 

- CRQ - Check request 

DEI - Demand exceeds installation check 

- OCA - Overcommitment algorithm 
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Overcommitment utility subroutines: 

- CAP - Count assigned packs 

- CAT - Count assigned tapes 

- CAU - Count assigned units 

- CDR - Check demand reached 

- DDS - Determine demand satisfaction 

- IAS - Initialize assignments 

- RSB - Read subsystem block 

VSNFILE subroutines (RESEXVF) 

- BVE - Build VSN entry 

- MVE - Make VSNFILE entry 

- SVE - Search for VSNFILE entry 

MAGNETIC tape assignment subroutines: 

- RMT - Request magnetic tape 

- ROA - Request operator assignment 

- VUR - Verify unit request 

Resource demand subroutines: 

- CRV - Check resource validity 

- GRI - Get resource demand entry parameter index 

- RDF - Read demand file 

- UDF - Update demand file 

Preview display subroutines: 

- BPD - Build PREVIEW display 

- EPB - Enter PREVIEW buffer entry 

Utility subroutines: 

- CFA - Check file attached 

- CLB - Clear buffer 

- CUP - Perform timed /event rollout 

- ERR - Error processing 

- GFN - Get family name 

- OPN - Open file 

- CET - Copy EST 

- PER - Process error message 

Common decks 

Buffers (overlay subsequent subroutines) 

Control card pre-processors 

- CCP - Control card pre-processor 

- PCV - Preset control point values 
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• AMO - Assemble magnetic tape options and call the following processors: 

SCD RTD SFS STD 

CRD SCB SID STF 

FID SCK SLT STK 

NMD SCV SNS VSP 

RTC SFA SPO WRL 

• Control card processing subroutines: 

- A OP - Analyze optional parameters 

- GRD - Generate retention date 

- CJV - Check job validation 

- CLP - Call POP (Pick Out Parameter) 

- FSC - File status check 

- ENF - Enter numeric label field 

- ILF - Initialize label FET 

- SVI - Set VSN index 

- TBD - Build tape block definition 

- VDD - Verify dependent defaults 

- VLC - Validate label call 

• External request subroutines: 

- CLF - Convert LFM call to FET 

- CSF - Convert SCOPE call to FET 

The two major routines in RESEX are: 

• RMT - Request magnetic tape 

• COMMIT - Exercise overcommitment algorithm 

Entry point processors which call these two major routines are shown in the diagram in 
Figure 9-8. The actual over commitment algorithm is contained in subroutine OCA 
The main control routine, however, is entered at COMMIT, as shown in Figure 9-8. 
RESOURC calls the algorithm routine, OCA, directly with prior calls to BRE and DEI 

Subroutine RMT performs tape assignment, calls MAGNET to get a UDT, and builds 
an FNT/FST entry for the file. The various subroutines called by RMT to perform 
this function are shown in Figure 9-9. 

9.2.1 COMMIT 

This is the main program for calling the overcommitment routine, OCA. Prior to calling 
OCA, the following subroutines are called: 

• BRE - Build resource environment (RET) 

• CRQ - Builds Request Block (RQ) and builds a demand file 

entry in buffer, RESB. 
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PFM 



LFM 



REQ 



ASSIGN 



LABEL 



REQUEST 




RESOURC 



Figure 9-8. Overcommitment Processing 




ICUPJ 
■COMMIT 
Figure 9-9. Routines called by RMT 
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Searches demand file entry just built in RE S3 to build the 
Resources Demanded Table (RDT) . Calls DDS to determine if 
demands are satisfiable. If not, "DEMAND INSTALLATION ERROR" 

DDS determines if resource demands are satisfiable. An 
attempt is made to assign equipment as follows: 

1. Resource demands are satisfied for larger multi-spindle demands 
first; tapes last. 

2. A demand is satisfied by a single equipment with a "best fit" 
determined by the largest spindle residue. 

3 . A demand is satisfied by a chain of equipment with no regard to 
spindle or equipment residue as a "best fit" criterion. 

4. If a demand cannot be satisfied, the previous demand satisfactions 
are negated and retried (step 2) . This is done until all possible 
chains are exhausted for that resource tv>e 



-j c - 



CFU - The requested VSN/PACKNAME, if found in EVSB, is assigned to 

the requestor . If equipment is a removable pack, a SHARE table entry 
is built. (The entry is part of the demand file entry beginning at RRPS) . 
If the request if for tape, and duplicate VSNs have been declared (VSN, 
T=A=B=C), they will be used if the original VSN is not found. If more 
than one VSN is mounted that matches the requested VSN, the operator 
is given the option to make the assignment. 

CRC - Determines if all demands are satisfied by the resources assigned. 
If so, the overcommitment algorithm (OCA) is not exercised. 

OCA - Overcommitment Algorithm. Determines if the assignment of 
the resource to the requestor will cause a potential deadlock. 
All jobs with assigned resources have their demahds written on a 
scratch file attempting to satisfy outstanding resource demands . If 
none of the job's demands are satisfiable, then "overcommitment" 
is said to have occurred. (Subroutine DDS is used to satisfy 
outstanding demands). 

BSF is called by OCA to build the scratch file containing demand file 
entries for all jobs with assigned resources. 

ORF - Updates the demand and assigned counts and SHARE table entries when 
files on resource devices are returned. When a tape unit is returned, 
the "assigned" count is decremented by I. When the last file on a 
removable pack is returned, the "assigned" count is decremented 
by 1 and the equipment number in the SHARE table entry is cleared. 
This causes the entry to be ignored or cleared on subsequent calls. 
The "demand" count is decremented by 1 only if satisfied. 
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RMT 



RMT is called to request a magnetic tape from MAGNET. The procedure is outlined as 

follows : 

• TBD is called to build Tape Block definition (TB) . That is, TBD maps portions 
of the tape description (FET+10B) into values for use in the RESEX-MAGNET 
call block. TBD computes the word count, overflow, unused characters, noise 
size, and fill according to the requested format, frame size, and noise size. 
TBD also establishes density and conversion mode (BCD, ANSI, or EBCDIC) 
and validates that the density is proper for the tape type. Finally, TBD ensures 
that options for ring enforcement or end-of-tape are not conflicting. On exit 
from TBD, FET+10B is updated to contain density and conversion mode. The 
format of the Tape Block (TB) definition word is as follows: 



48 47 



36 35 



24 23 



12 11 



wc 


UC J FO 


EO NO 


PO 



where: 

WC 
UC 
FO 



Word count per tape block 

Unused character count and overflow 

Tape format: 



Value 



1 
2 
3 
4 
5 
6 
7 



Format 
X 

s 

L 
E 
B 
F 



WC = 1000B 



EO - EST ordinal of tape unit 
NO - Noise size 

PO - Processing options (Refer to Section 7 of the KRONOS 2. 1 Reference 
Manual) . 

• Store VSN into RQ. (Read from FET+11B. ) Then Store jobname and sequence 
number in RU and RS of request block. 

• Call COMMIT to exercise the overcommitment algorithm. 

• If the request cannot be satisfied now, RESEX enters timed-event rollout, other- 
wise VUR is called to validate the unit request and call MAGNET. 

• VUR assigns the tape to the requester by sending the "call block" to MAGNET. First, 
the UDT is read (from MAGNET) to verify that the VSN has not changed, and that the 
unit has not been assigned to another job. Next, the conversion field in the UDT is 
checked to ensure that MAGNET could make the requested conversion change. If 
the tape is being assigned automatically, LFM is called to assign the equipment. 
Next.acallblock is built from tape descriptors (FET+10B), VSN information, and 
other UDT information. If the tape is a KRONOS 2.1 labeled tape, the accessibility 

is verfied (see description of file accessibility on page 7-41 of the KRONOS 
Reference Manual). The format of the block is as follows: 
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36 35 


24 23 


12 1 


I 




Ill 1 

Interlock 


[ UO 


UDT address 




D 


c 




TB 






SN 




VI 


VA 


Jobname 


OT 




VSN 1 



where: 



UO - User options 

D - Density 

C - Conversion type 

TB - Tape block definitions established by subroutine TBD 

SN - Job sequence number 

VI - VSN index 

VA - VSN random address 

OT - Job origin type 

The call block is sent to MAGNET. After Magnet responds, the UDT is 
reread to verify that the tape has been assigned correctly. If not, the call is 
repeated. If MAGNET has assigned the tape, VUR builds the tape file FNT/FST 
according to the following format: 



FNT 
FST 



48 


47 36 35 24 23 




12 


11 


File Name 




Type i I CP 


[ idLeoJ 


UDT adr i F i T 


VA 




* 1 










^labeled flag 



where: 

F 
T 
VA • 



Format (0-7) 

Type (0-7) 

VSN random address 



Finally, VUR issues the assignment message: 
"xxxx ASSIGNED TO fffffff, VSN = nnnnnn , " 



where: 

xsex 

f-f 
n-n 



- Unit number 

= File name 

= Volume serial number 
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RMT will then call UDF to update the demand file using the entry in the RESB 
buffer. UDF also updates word UJSQ of the control point area to contain the demand 
file random index for this entry. 

RMT then calls BPD to build the PREVIEW display (E . P . ) . This information is 
sent to MAGNET'S field length where DSD can read it for the display BPD builds 
entries for the PREVIEW buffer by using the RQPD field of the demand file entry. 
The first word in the buffer contains the length of the buffer. Entries are two 
words and are in a hierarchy based on the number of additional units required and 
the maximum units returned at job completion time. The first entry is the last 
requestor (if any). Entries might also contain data from MAGNET UDTs when 
ring-enforcement requires remounting the tape or when VSNs are needed for 
multi-reel processing. The entry format is as follows: 

RQPD is one of the two following formats depending on whether its a Tape or a PACK. 



RQPD word 



USER NUMBER 



42 



2 10 

FST address 



where: 



RQPD is the RQPD word from the demand file entry with one of 
the following formats : 



PACKS 



59 




18 


17 







Pack Name 


RT 



TAPES 



VSN 



RT 



where: 



R - Ring -in flag 

RT - Resource type (MT, NT, DB1, etc.) 
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The following is a dump of MAGNETs FL and the RESEXDF and RESEXVF files. 



TABLE 9-4. MAGNET - RESEX 



Foil 



Word 



Description 



127703 

127704 
127706 
127710 
127722 
127723 



Picture of E,T and E,P display and job sequence. 

Start of MAGNET fl. Refer to figure 9-2 WORKSHOF 
manual 6 UDTs, start at 1060 and end at 1264. 

Queue start at 1265 

XREQ empty 

I MT interlock words 

FL status word 

TFUN 1MT function table 





127735 


RCAL see p. 9-21 Workshop manual interlock = 


= 


i 


127736 


UDT address = 1106. UO=4 




1 


127737 


D/C = 300 






127740 


TB = 100510400 






127741 


SN = AABF, VA = 1 






127742 


Jobname = JOB1 ABFA 






127743 


VSN = ONE001 




2 


127744 & 127745 


tfoused 






127746 


VSN=SIX, eq=DIl 

ITN=MLO, FST addr 3313 






127747 


Start of E,P display 






127750 


VSN=FIVE, EQ = MT 






127751 


UN=MLO, FSTadr=3331 






127752 


USN=TWO001, EQ=MT 






1277S3 


UN=MLO, FSTadr =3323 
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TABLE 9- 


•4. MAGNET - RESEX (Continued) 


Foil 


Word 


Description 


3 


130760 = {relative 1060) 


Start of UDT See 9-6 Workshop 




130764 


See COMSMTX UST1 




130767 


See COMSMTX UST4 




130772 


See COMSMTX ULRQ 




130775 


Job Seq = AABG CP=3 




130776 


Jobname = JOB2ABGA 




131000 


VSN = ****50 




131001 


FI=unlabeled 




131004 


Generation number = 1 




131005 


UDAT = date 




131165 


Queue table 


3 


131171 


end of Queues (not shown) 




131177 


end of MAGNET (not shown) 




TABLE 9 


-4. MAGNET - RESEX (Continued) 


Foil 


SE 


Description 


4 





Start of RESEXDF see figure 9-6, Workshop Manual 


A 


1 


RJSQ = AABC 

RJBN = JOB5ABCA 

RVAL = MT = 4, NT = 4, from VALIDUX 

RMTP = DI1 assign = 0, req = 1 

RQPD = SIX, type = DI1 

RQPU = MLO fst addr = 3313 

RQPT = 40723134220 
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TABLE 9-4. MAGNET - RESEX (Continued) 



Foil 



SE 



Description 



RJSQ = AABF 

RJ3N = JOBiABFA 

RVAL = MT = 4 , NT = 4 from VALIDUX 

RMTP = MT assign = 1, req = 2 from RESOURC card 

RQPD = TWO001 type = MT 

RQPU = MLO Fst addr = 3323 

RQFT = time = 40723134710 

RJSQ = AABH 

RJBN = JOB3ABHA 

RVAL = MT = 4, NT = 4 







RMTP assign = 0, req = 1, no RESOURC card j 

i 






RQPD = FIVE type = MT, etc. 


5 


4 


JOB2ABGA RMTP MT assign = 1, req = 1 , etc.- 
No RESOURCE card 


5 


4 


EOR Job5 was an old entry and is ignored since 
this EOR is an empty sector. 




40 


EOI 


6 




Start of RESEXVF, see figure 9-13. 


6 


1 


VJSQ =AABF 
VJBN = JOBIABFA 
VLFN = ONE 

von = 1 

WSN = ONEOOl 


6 


2 


VJBN =JOB3ABHA 
VLFN = FIVE 
VDFI = 2 



Note: 1 sector /job using allocatable devices. 
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TABLE 9-4. 


MAGNET - RESEX (Continued) 




Foil 


SE 


Description 


7 


3 


VJBN = JOB2ABGA 
VLFN = THREE 
VDFI = 3 




7 


4 


VJBN = JOB1ABFA 

VLFN = TWO 

VDFI = 1 Note: same job as one above. 




7 


5 


EOR Job 4 is an old entry and is ignored. 




7 


40 


EOI - There is no entry for SIX for JOB5 since 
is not yet assigned. 


it 
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10.0 INTRODUCTION 

This section describes the two KRONOS 2 . 1 file managers: Permanent Files and the Local 
File Manager. 

10. 1 PERMANENT FILES 

Permanent files are controlled by the system PPU routine, PFM (Permanent File Manager) . 
All requests for permanent file action are accompanied with a specific user number. User 
numbers are established by installation personnel and entered into the system validation 
file, VALIDUX. Thus, only users known to the system may request permanent file action. 

There are two types of permanent files available to users of KRONOS: direct and indirect 
access files. 

• A direct access permanent file is read and written by user I/O requests 
just as any local file would be read or written. Large data files occupy 
large amounts of mass storage and are normally created as direct 
access files. 

• An indirect permanent file is accessed by using a working copy of the file 
rather than the file itself. The working copy is attached as a local file to 
the user job. Thus, modifying the working copy does not alter the actual 
permanent file. Indirect access files are allocated in 64 CM word blocks 
and are generally used for small permanent files. 

A direct access permanent file is normally declared by the user prior to writing the file 
by using the DEFINE control card or macro. However, this control card may be used 
after the file is written, if desired. Indirect access permanent files are declared by the 
SAVE control card or macro after the file has been written. 

Whenever a permanent file is declared, the user number is mapped into a CATALOG 
track where permanent file names and statistics for that user are maintained. Thus, there 
is one catalog entry for every permanent file known to the system. A catalog track normally 
contains entries for several different users. A description of this mapping is provided in 
Section 4 of the KRONOS 2. 1 Installation Handbook. 

A family consists of 1 to 63 mass storage devices. Within a family, each user has a 
master device that contains his permanent file catalogs, all of his indirect access files, 
and some or all of his direct access files. Again, the mapping of a user index into a 
master within the family is shown in Section 4 of the KRONOS 2. 1 Installation Handbook. 

97404700A 10-' 



If more than one family is available in the system, the user must specify which family via 
the ACCOUNT control card. 

A user may specify a list of other users permitted to access his permanent files. This list is 
specified on the PERMIT control card or macro, and results in adding an entry to the PERMIT 
buffer. 

PFM is the permanent file manager routine. It is called to a PP either by an RA+1 call 
generated by the user CP Macros, by a control card call, or by TELEX. 

1 . A CP programmer may use any of the PFM calls described in the reference manual. 
These calls will produce an RA+1 call to PFM . 

2. Any PFM control card will cause the CP routine PFILES to be loaded in the user FL. 
PFILES will issue the PFM macro calls which result in an RA+1 request for PFM . 

3. A user on a TTY can issue PFM requests with the proper TELEX time sharing commands. 
With the exceptions of CATLIST, TELEX will call PFM directly with an RA+1 request. 
The terminal user does not need to be sent to a CP . The CATLIST command however , 
must be issued from a CP since the call block will not fit into one POT. TELEX 

will issue a dummy CP to issue the CATLIST call to PFM . 

As a review , the two types of PFs are shown below: 

PERMANENT FILES 



DIRECT 

LARGE files 

Track allocation 

single copy 

write interlock 

multi-read (multiple FNT/FST) 



DEFINE (lfn=pfn) 
ATTACH(lfn=pfn) 

Fast Attach capability from the macro 
ATTACH pfn,,,,,,,FA 
andlSF. ISF(R= ) 



INDIRECT 

SMALL files 

sector allocation 

multi -copy 

each user gets 
his own copy 
of the file . 

SAVE, pfn 
GET.pfn 
REPLACE, pfn 



PERMISSIONS: 

Read, Execute only. Write, Append, Modify 
either explicitly 
or implicitly 
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lgure 10-1,1 Permanent Files 



IAPF 


Label 

Track 


Permit 

Track 


Number 
Cat Tracks 


System 
Table Track . 



TYPE 

implicit permissions PUBLIC, SEMI -PUBLIC 

explicit permissions PRIVATE 

requires 

PERMIT(pfn,usemum=mode ,PN=packname ,R=r,NA) 

10.1-1 Master User of PFs. 

UN where "*" occurs can access any PF in read mode for an UN whose after characters 

correspond to the master user. 

For example, UN ABC* can access all the PFS of UN ABC1 , ABC2, ABCX, in fact any 4 char- 
acter UN whose first three characters are ABC. When a user requests PF activity PFM will 
use the users User Index, UI, to map to that particular users Master device and catalog track. 
The algorithm for this mapping is in the Installation Handbook part IV. 

Each Master Device, MD, has a predetermined number of catalog tracks. The MST DEVL word 
4 contains PF information. 

DEVL 

Byte 3 contains the actual number of tracks which are catalog tracks . They must be 
contiguous tracks. Byte 1 is the first track of the label track chain. This track chain 
consists of the label and all the catalog tracks . Normally the label track is track , 
however , if track is flawed , then the first available track will be used . The d bit is set 
in the TRT so that this track chain is preserved across deadstarts. Normally, then, track 1 
will be the first track of the catalog tracks. Only MDs have catalog tracks, so for a non 
MD device the Label track chain consists of only 1 track. 

However , if all the catalog tracks cannot be contiguous starting at track 1 , then the first 
available contiguous tracks large enough for the catalog will be used. In this case bit 
11 is not set in the PFDL word MST+6, and the 1st catalog track is pointed to by the TRT 
link from the label track position . 

Since each user is mapped to a particular catalog track, and these tracks are contiguous, the ■ 
link byte in the last sector does not link to the next track in the chain. If this track becomes 
full, catalogs cannot overflow to the next contiguous track (other users are mapped to that 
track) . A new track is linked into the chain via the TRT table , and the last sector link byte 
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points to this new track. Effectively then, PFM has just increased the length of this catalog 
track. This, of course, will slow down PFM when he has to search more than 1 catalog track 
for any one user. So bit 10 is set in PFDL and an is displayed in the E, M display. 

Many users can be mapped to any specific catalog track, but no user can be mapped to more 
than one catalog track fln case of overflow, it is considered a very long track). 

As a user creates PFs an entry (Figure 10-1) is placed in the appropriate catalog track and the 
file is processed by PFM. 

If the PF is direct access file DPF, then 1) If the file resides on a device in the users family 
which can contain PFs the entry is created and the first track is recorded, the first sector entry 
is set to 4000B denoting a direct access PF. Since this is a regular file, sector will contain 
the system sector, and Sector 1 will be the first sector of data. PFM will issue the STBM 
function to set the d bit in the TRT. 2) If the file does not reside on such a device, the Job 
is aborted unless error processing was desired. In order to avoid this possibility, the user 
should DEFTNE the file prior to writing on it. 

If the PF is indirect PF IFP, then the entry will be copied from the regular file which is to be 
made permanent; i.e. , DPF are regular files which have the d bit set in the TRT. IFP are not 
kept as regular but are allocated by PFM, and the system does not keep track of them. The 
user must create the file first, and then issue the SAVE command. 

PFM keeps an IPF track chain. This chain is reserved from the system as a normal file chain, 
the d bit is set to preserve it over deadstarts. Word DEVL byte points to the first track of 
this chain. The chain is kept to a minimum length when possible, and is expanded RTCM and 
contracted DTKM^orDLKM a^ec¥ssary. However, the IPF track chain^must completely reside 
on its MD since every user mapped to the MD must have all his IPFs on this device. The 
format for the file is shown below. Note that Sector is the system sector of the IAPF and 
sector 1 is an eoi, Hence Sector 2 contains the 1st data which is the 1st IPF saved. 
1 n n + 1 



SS 


eoi 


1st file 


eoi 


2nd file 


eoi 


etc 



As each SAVE command is processed, PFM will get n contiguous sectors (the length of the users 
file not counting the system sector) on the IPF chain. It wilt copy the users file exclusive of 
the system sector, but including the EOI. The number of sectors copied, not counting the .EOI 
sector is saved in the catalog entry as well as the first track and sector number of the file. 
Sector 4000B does not exist so there is no confusion between DPF and IPF entries in the 
catalog entries. 
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As more files are SAVEd and DEFINEd the catalog entries grow and grow and could cause 
overflow as we have seen described earlier. However, available slots in the catalog 
entries are created by PURGES of PFs. These available slots are known as holes. 

When a DPF is purged, the UI is set to zero, the number of sectors is set to zero, and all 
the tracks in that file chain are released to the system. This hole can be used for new 
DPFs or new IFPs . 

When an IFP is purged, its UI is set to zero, however, the sector count field is left intact. 
The sectors are not released physically unless the file was so large it spanned one or more 
whole tracks. In which case, the tracks are returned to the system DLKM, and the sector 
count field is set to the remaining sectors . This hole can only be used by new IPFs . 

In the case of the REPLACE command, the following occurs: 

1 . If the new file is the same si2e as the existing file , the new file is copied over 
the old IFP file . 

2 . If the new file is smaller than the existing file , the new file is copied over the 
the old one, the sector count field is modified, and a new PF catalog entry is built. 
This entry has UI=0, and sector count field set to the remaining sectors, and first 
track and sector pointing to the remainder of the old file. 

3. If the new file is larger than the old file, the current entry is set to a hole, UI=0. 
A new hole is found if one big enough exists , or the new file is placed on the end 
of the IAPF, and a DPF hole or a new catalog entry is used. 

Hole searching is accomplished the same way for both a SAVE and a REPLACE command. Only 
the catalog track (plus overflow tracks, if any) mapped to by the UI of the user are searched; 
i.e., the entire catalog track is never completely searched. 

1 . If a hole with the exact number of sectors available is found, it is used. 

2 . If not 1 , then the largest hole , larger than the file is used . 

3 . If not 1 or 2 , then the file is put on the end of IAPF and a new entry or a DPF catalog 
is used. 

The scheme of searching for largest residue holes makes the best utilization of the IAPF, since 
very small holes seldom get filled. Eventually, of course, the IAPF gets very holey, and a 
PFDUMP and PFLOAD are the only solution . PFLOAD will recreate the catalog entries and 
IAPF with no holes . 
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When a GET command is issued, PFM will find the entry, and copy the file from the IAPF to a 
local file and create an FNT/FST entry for this local file with the proper permission bits set. 
PFM counts the sectors copied (exclusive of the eoi) and compares them with the sector count 
field, and if they do not agree it will issue a file sequence error. 

When an ATTACH command is issued, PFM will find the catalog entry and create an FNT/FST 
pointing to this file. The file type is PMFT and the permission bits are set accordingly. 

Of course on any GET or ATTACH command, PFM will be mapped to the proper catalog track and 
will ensure that the user has either explicit or implicit permission to use the file . 

In the case of implicit permission the file is made available . 

In the case of explicit permission, the catalog entry points to a permit track, where the 
permission entry for this file resides. Byte 2 of DEVL points to the first such track. This entry, 
figure 10-2, indicates the permissions available to this user. 

In all cases, the original owner of the file always gets all permissions when he or she requests 
it from PFM. 

Finally, PFM always searches the FAFT type entries in the FNT/FST first on any ATTACH 
function. Then PFM searches the appropriate catalog track. 

In the case of an FAFT file , PFM knows the family of the requestor , and can return the proper 
file in the case of duplicate PF names in different families . The FAFT requestor is returned a 
PMFT type FNT/FST entry. This just allows an FAFT file to be found quickly, hence the name 
Fast Attach File . 

Formats of the catalog entry and PERMIT buffer are shown in Figures 10-1 and 10-2. 
59 __ _ 48 47 36 35 24 23 18 17 12 11 




Figure 10-1. Catalog Entry Format 
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where: 

A - if FIRST SECTOR = 4000B this is a DPF 

random index - the random disk address of PERMIT sector 

Access count - the number of times this file was accessed 

ct - file category as follows: 

= private 

1 = semiprivate 

2 = library or public 

mode - Mode of access for semiprivate and public files 

as follows: 

= write, read, execute, append, modify, and/or purge 

1 = read and/of execute 

2 = append 

3 = execute 

4 = negate previous permission 

5 = modify 

6 = read and/or execute, allow modify 

7 = read and/or execute , allow append 



Figure 10-1. Catalog Entry Format (Continued) 
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dn 



date /time 



program control 
word 



Device file resides on (0-77B). If 0, file resides 
on master device, dn t for a direct access file 
residing on a device other than the master . 

All date and time entries are in octal with the 
following format: 

yymmddhhmm s s 
yy is biased by 70. 

User control information from FET+11D. 



Figure 10-1. Catalog Entry Format (Continued) 



59 



36 35 



18 17 



M 

y 



77B 



Random index 



User index 



date and time 



Permitted user number 



Access count Mode Access time 



User index 



Access date 



used for 
linkage 

up to 31 
PERMIT ent- 
ries (2 
words per 
entry, >31 
overflow to 
next sector) 



where: 
random index 

user index 
Access count 



Mode 

Access Time/ 
Date 



Disk address of next PERMIT buffer for this user 
index. Zero indicates end of chain. 

User index who created this sector. 

The number of times the permitted user has accessed 
the file. 

Mode of permission given to user 

Time and date of last access by permitted user. 



Figure 10-2. PERMIT Buffer 
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The permanent file manager can be called in two ways: a system call or a TELEX call. 
The call formats and call blocks are different for the two calls as shown in Figures 
10-3 through 10-6. 

• System call initiated from the CP routine PFILES, or a system call is from 
a macro. 



IR 



PFM 


CP# 


cc 




FET 



18 



12 



18 



where: 

FET 
CC 



Address of the 14- word call block 
Command code (request) as follows: 



Symbol 

CCSV 

CCGT 

CCPG 

CCCT 

CCPM 

CCRP 

CCAP 

CCDF 

CCAT 

CCCG 



Value 

01 
02 
03 
04 
05 
06 
07 
10 
11 
12 



Command 

SAVE 

GET 

PURGE 

CATLIST 

PERMIT 

REPLACE 

APPEND 

DEFINE 

ATTACH 

CHANGE catalog data 



Figure 10-3. System Call Format 
The 14-word call block pointed to by FET is shown in Figure 10-4. 



FET+0 



FET+8 

+9 
+10 
+11 
+12 
+13 



59 



dt 



48 47 



36 35 



logical file name (lfn) 



Permanent file name (pfn) 
Optional user number (ovan) 



24 23 



18 17 



Optional file password 



Program control word (pew) 



pack name (pknT 



new file name (nfn) 



SS 



12 11 







STATUS 



FIRST 



IN 



OUT 



LIMIT 



ct mode 



erad 



units 



CFPN 
CFOU 
CFPW 
CFUC 
CFPK 
CFNF 



Figure 10-4. System Call Block 



10-4 



97404700B 



where: 

Status - Bit must be zero prior to calling PFM. 

Error codes are returned in bits 10-17. 
Bit is set to one upon completion of the request. 

First - Buffer pointers are used by CATLIST function 

dt - Device type of file residence 

ep - Bit 44. If set, control is returned to the user on errors. 

pfn - Permanent file name. If zero, Ifn is used. 

ct - File category (private, semi private, library). 

mode - File access mode 

ovan^ - Alternate user number 

* 1 
no - Number pf FRUs required for the direct access permanent file 

being DEFINE'd. 

erad - Address where error messages are returned. 

The message may be up to three words long and is stored at the 
given address only if ep is set. 

pew - Program control word. Whatever the user stores in this word is 

stored in the catalog entry when a permanent file is created. This 
word is read from the catalog entry and stored in CFVC when the 
file is attached. 

SS - Sub-system designation set by TELEX when the file is being accessed 

via the time sharing executive. 

pkn - Name~of~Qre~auxiliary device to be used in satisfying the permanent 

file request. 

units - The number of units of the type specified by dt. For example, 

if the device type is DI4, the dt field contains DI and the unit field 
contains 4. 

nfn - New file name used with the CHANGE command. 

*1 Mutually exclusive fields, FET may contain either but not both fields. 

Figure 10-4. System Call Block (Continued) 



TELEX Call 

A TELEX call is initiated by a call from the time-sharing executive. The call 
format is shown in Figure 10-5 while the call block is shown in Figure 10-6. 
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IR 



PFM 
18 



CP 



cc 

12 



TN 
12 



JPP 
12 



HI 



where: 

CC 

TN 
PP 
CP 



Command code as for system call. 

Terminal number used to index into the terminal table within TELEX. 

Pot pointer used to locate the call block (also within TELEX) . 

CP number equals 1 indicates TELEX call when TELEX running. 





Figure 10-5. TELEX C 


:all Format 








59 18 17 


12 11 










logical file name 


STATUS 


TXSN 


1 


file name table (FNT) entry 


TXFT 


2 


file status table (FST) entry 




TXFS 


3 


permanent file name 


ct 


mode 


TXPN 


4 


optional user number 




TXOU 


5 


file password 


rclad 


TXPW 


6 


program control word 






TXUC 


7 


packname 


eq 


l 


cfLs 


TXPK 


where; 










rclad 


Address of input register if recall needed 


. 






eq 


Equipment in family to be accessed. 








ctls 


User control bits 











Error messages are returned in words 0-4 of TELEX call block. 



Figure 10-6. TELEX Call Block 



Routines called by PFM include the following: 



• 


OAV • 


account verification 


• 


OBF 


begin file 


• 


ODF • 


drop file 
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The important thing to remember here is that the lengths of these three routines are 
defined as assembly constants in PFM. Thus, any change in their lengths might affect 
their loading in PFM. 

PFM consists of a few resident subroutines and the following overlays: 

3PA - Command processor 

3PB - SAVE, REPLACE, APPEND processors 

3PC - APPEND processing 

3PD - ATTACH processing 

3PE - Catalog list routines 

3PF - DEFINE processing 

3PG - PERMIT/PURGE processing 

3PH - Error processing 

3PI - Auxiliary routines 

3PJ - CHANGE processing 

There are four addresses where the 3P(x) overlays are loaded. One address, OVLA, is 
defined in the main routine, PFM. Two are defined in overlay 3PA. They are BUF and OVLC. 
The last address, BFMS, is defined in SYSTEXT. Figure 10-7 shows the 3P(x) overlays, 
their load addresses, and their approximate lengths. Overlays loaded at OVLA should 
not extend beyond BFMS, while those loaded at OVLC should not extend beyond OVLL. 
There is enough space between OVLL and OVLC to allow for one full PRU, plus one short 
PRU. (this jis [the concern of the PP resident loader). 

Not shown in Figure 10-7 are the load addresses for the 0-level overlays. These 
overlays include OBF, ODF, and OAV as mentioned earlier. However, these routines have 
been taken into consideration in that their lengths have been included in the 3P(x) overlay 
lengths shown in Figure 10-7. Furthermore, the load addresses for the 0-level overlays 
arc referred to by the symbol, LOCF, in the 3P(x) overlays and, as such, are quickly 
located with the aid of the symbolic reference table when looking at the listing of PFM. 
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o 
I 

00 




I 

PFM 
3PA 



IK 
i 



2K 



3K 



PPFW 



L 



PRESET code 



OVLA 
Resident subroutines 

i I 



OVLA BUF 



, jm, . 



BUF+5 



3PE 



OVLA 



3PH 



OVLA 



4K 
l_ 

J i 



5K 
i_ 



6K 



7K 



7777 



LOCF OAV 



BUF2~ " BUF 1 " ' BFMS BFMS 1 502 



± 



OVLC 

3PB 



OVLC 



3PD 



OVLC 



h 



3PF 



OVLC 
3PG 



I- 
OVLC 



«- 



3PJ 



OVLC 



_L 



J 



OVLL LOCF 



| 3PI ! 
BFMS 



co 

o 

-J 

o 

§ 



— I — 

2K 



3K 



4K 



5K 



6K 



Figure 10-7. PFM Overlay Load Map 
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7777 



10. 1. 1 PFM - Permanent File Manager 

PFM provides storage for the call block and other temporaries. Its resident subroutines 
are: 

SFA - Set FET Address 

CCI - Clear Catalog Interlock 

DPP - Drop PPU 

TTA - Set Terminal Table Address 

ERR - Process Error 

SFN - Set File Name in CM 

MSR - Mass Storage READ Error Processor 



PFM presets processing routines to: 

Verify FET parameters 

Verify user validation allowances 

Place request in recall if catalog is interlocked 

Issue accounting messages 

Load proper function processor overlay (3PA or 3PE) 

Call RESEX if pack is unavailable. 



10. 1.2 3PA - Main Command Processing 

3PA performs all processing required to perform the GET function. 3PA performs 
preliminary processing fbr~the ToUbwing commands: 



SAVE 

ATTACH 

PURGE 



PERMIT 
APPEND 
DEFINE 



CATLIST 

REPLACE 

CHANGE 



3PA also contains: 



Catalog processing routines 

PERMIT processing routines (some) 

File allocation routines 

General subroutines 

Device- to- device transfer routines 
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The following outline describes 3PA subroutines and buffers in more detail. Many of the 
3 PA subroutines are called from other 3P(x) overlays. Those called from another overlay 
are labeled with an asterisk. 

• 3PA resident routines include: 

* TRP - terminate program 

TST - terminate TELEX request 
*EOI - write end -of -information 

• Resident common decks include: 

COMPSNT - set next track 

* COMPRNS - read next sector 

• Device-to-device transfer routines include: 

* DTD - main routine 

PTE - process transfer error 

* IBA - increment buffer address 

* SDP - swap disk parameters 

* WNS - write next sector 

• * BUF - device-to-device transfer buffer overlays subsequent 

subroutines 

• PERMIT subroutines include: 

* CPE - create PERMIT entry 

* CPI - check permission information 

* UPI - update permission information 
CSA - compute sector address 

SPI - search permission information 

PPE - process PERMIT read error 

WNP - write new PERMIT buffer 

FPE - form PERMIT entry in buffer 

• Catalog processing subroutines include: 

* CCS - create catalog sector 

* DCE - delete catalog entry 
FCE - form catalog entry 
FHE - form hole entry 

* UCE - update catalog entry 

* SSC - select catalog entry 
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* SCH - search catalog 

PCE - catalog READ error processor 
CCD - check catalog data 

• Allocation subroutines include: 

AFS - allocate file space for indirect file 
ACS - allocate catalog space 
APS - allocate PERMIT space 

• General subroutines include: 

* DIK - drop tracks 

* ITC - interlock track chain 
RTK - request linked track 

* WBI - write buffer in place 
COMPCRA - convert random address 

* COMPSEI - search for end-of-information 

* COMPCTI - clear track interlock 

* COMPSTI - set track interlock 

* COMPCKP - set checkpoint bit in EST entry 

• OVLC - command processing overlays are loaded here and destroy 

the following subroutines. These overlays must not exceed OVLL. 

• GET and ATTACH processing routine 

a Command processing initialization - SET 

• Catalog search initialization subroutines include: 

* ISP - initialize search 

* SPN - set permanent file name 

* COMPSAF - search for assigned file 

* COMPSFB - set file busy 

3PA calls many of the other 3P(x) overlays. 
Those called are shown in Table 10-1. 
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TABLE 10-1. OVERLAYS 3P(x) CALLED BY 3PA 



Overlay 


Load 


3PA Subroutine 


Command 


Name 


Address 


Called From 


Processed 


3PI 


BFMS 


ISP 




3PB 


OVLC 


SET 


SAVE/APPEND/REPLACE 


3PJ 


OVLC 


SET 


CHANGE 


3PF 


OVLC 


SET 


DEFINE 


3PF 


OVLC 


SET 


PURGE /PERMIT 


3PD 


OVLC 


GET 


ATTACH 



10. 1. 3 3PB - SAVE/ REPLACE /APPEND Processing 

The 3PB overlay contains subroutines for processing the commands: SAVE, REPLACE, 
and APPEND. It also contains some common subroutines. An outline of the subroutines 
comprising 3PB is given below: 

• APP - process APPEND command 

• REP - process REPLACE command 

• SAV - process SAVE command 

• Subroutines include: 

CUC - check user controls 

PFR - process file replacement 

SSP - set statistical parameters 

SSF - search for system file 

PRS - preset 3PB 

Only one overlay, 3PC, is called by 3PB from subroutine APP. 

10. 1. 4 3PC - APPEND Processor 

Overlay 3PC is loaded at BUF+5 by subroutine APP in overlay 3PB to process the APPEND 
command. The order of the transfer is as follows: 

• the old permanent file is copied to a new permanent file, then 

• the local file is copied to the new permanent file. 

10. 1. 5 3PD - ATTACH Processor 

Overlay 3PD is called from subroutine GET in overlay 3PA to process the request to 
attach a direct access file to a job. 3PD consists of the following subroutines: 

• ATT - process ATTACH command main program 

• CFM - check file mode 

• Common decks: 
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COMPSDI - set P. F. device interlock 
COMPRSS - read system sector 
COMPWSS - write system sector 

• MSS - read system sector error processor 

• CFA - fast attach file processing 

• COMPFAT- search for fast attach file 

Subroutine ATT calls OBF for fast attach files. 

10. 1. 6 3i J E - Catalog List Routines 

Overlay 3PE is called from the preset subroutine, PRS, in the main program, PFM. 
3PE is loaded at OVLA and is called to read permanent file catalogs for a central processor 
program. Data is returned to the CM buffer specified by the FET pointers: FIRST, IN, 
OUT, and LIMIT. The PFM call format for this request is: 



RA + 1 



PFM F P* I CCCT I 1 FET 



18 6 

* Recall Bit if desired. 



12 



18 



The call block pointed to by FET is shown in Figure 10-8 . 



FET-hO 



FET+6 



59 



18 17 



logical file name 


Status 




FIRST 




IN 




OUT 




LIMIT 




Reserved 




permanent file name 


mode 


ovan 





where, 

status 

FET-6 
Mode 

Ovan 



33 if buffer is full 

1033 if request completed (buffer is filled from IN to LIMIT - 1). 

Reserved for recall information to PFM 
to search catalog entries 
to search permit entries 

Alternate user number thus search alternate catalog. In this case, 
the password and user index are cleared before being written 
to CM buffer . 

Figure 10-8. PFM CaU Block 
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Overlay 3PE consists of the following subroutines: 

CAT - main program 

NCS - normal catalog search (mode = 0) 

ACS - alternate catalog search 

PDS - PERMIT data search 

SBS - set status of FET (update IN) 

RBS - read buffer for search 

SHB - search catalog buffer 

WDB - write buffer 

CCP - check catalog permission (clear password) 

DFS - determine file size (store in catalog entry) 

SPB - PERMIT buffer search 

CSA - compute sector address 

Common decks include: 

COMPCRA - convert random address 

COMPSRA - set random address 

COMPSEI - search for end of information 

COMPRNS - read next sector 

COMPSDN - search for device number 

• Buffers BUFA and BUFB overlay following code 

• CSU - check for special user 

• ISP - initialize search of catalog with 

COMPSCA - set catalog address 

10. 1. 7 3PF - DEFINE Processor 

Overlay 3PF is called to create a direct access permanent file. The file exists prior to 
the DEFINE command, or the file may be created after the DEFINE command. File 
residency is determined in 3PF for the two situations as follows: 



• 
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Local file exists - the local file is made permanent if the local file resides 
on a PF device; otherwise, the request is aborted. The dt field of the call block 
is ignored. If the local file resides on a removable device, that device's pack- 
name must be the same as the packname specified in the call block. 

No local file - If the dt field is zero, the file is placed on the device with the 
most available space. If dt is specified, the file is placed (started) on the device 
of that type with the most available space. If np (number of PRUs) is specified, 
the file is placed on the device (type dt, if specified) with the most available 
space, provided that np PRUs are available. If np PRUs are not available, 
the request is aborted with the message: "PRUS REQUESTED UNAVAILABLE". 
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3PF writes a system sector for the file to reflect the permanent file status of the file. 
The catalog entry is stored in the system sector as indicated in the format below. However, 
note that byte 2 of word 1 is updated to indicate the current access modes. Also, word 
CTSP may contain the catalog pointers. However, there are no references to this word in 
PFM, so it may be assumed that the word is unused by PFM. Nevertheless, the format 
of the system sector is shown in Figure 10-9. 





1 
2 
3 

4 
5 

6 
7 

10 

11 



21 
22 

77 



59 



48 47 



36 35 



24 23 



12 11 



logical file name 



EQSS 



FTSS 



date and time 



Word of catalog entry 











am 



Words 2-7 of 
Catalog Entry 



& 



rm ra 



unused 



CTSS 



CTSP 
CTUC 



where, 



EQSS 


- 


FTSS 


- 


am 


- 




bit 




24 




25 




26 




27 




28 




29 



Equipment number of system sector 

First track 

Current access modes as follows: 

meaning 

file currently attached in read mode 

file currently attached in write mode 

not used 

file currently being modified or may be modified 

file currently being extended or may be 

file purged 

Figure 10-9. System Sector Format 
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rm - Number of users with RM or M access set to zero by 3PF. 
ra - Number of users with RA or A access. Set to zero by 3PF. 
r - Number of users with R or W access. Set to 1 by 3PF. 

Figure 10-9. System Sector Format (Continued) 

Overlay 3PF consists of the following subroutines: 

DEF - main routine to build catalog entry write system sector. 

CUC - check for maximum number of files reached. 

DFR - determine file residency 

CPR - check for proper family or pack name residency. 

DDN - determine device name from MST entry. 

10. 1.8 3PH - Error Processor 

Overlay 3PH contains the error processing routines for all other overlays. It performs 
the following: 

Sends the indicated error message to the dayfile. 

Sets the FST entry "not busy", or 

Deletes the FNT/FST entry if created by PFM 

Terminates the calling program if user error processing is not specified. 

Drops the PPU 

If a TELEX call: returns error message in a POT, sets the completion bit, 
and drops the PPU. 

Overlay 3PH contains a list of error messages issued by PFM. This list is available in 
the KRONOS 2. 1 Reference Manual. Some messages are sent to the control point dayfile 
while others are sent to the error log. 

10. 1 . 9 3PI - Auxiliary Routines 

Overlay 3PI contains auxiliary routines used by many of the other 3P(x) overlays. These 
auxiliary routines can be overlayed after execution by any process that uses BFMS since 
3PI is loaded at BFMS. Currently, 3PI contains two common decks: 

COMPSCA - set catalog address, and 

COMPSDN - search for device number 

3PI must not extend beyond BFMS+502. 
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10. 1. 10 3PJ - CHANGE Processor 

Overlay 3PJ processes the CHANGE command by changing and replacing the catalog 
entry for a file . 

10. 1. 11 SAVE Command Processing Flowchart 

The flowchart Figure 10-10 represents processing for the SAVE command. Subroutine 
SAV is contained in overlay 3PB which has been called from 3PA. Notice that control 
returns to 3PA by entering subroutine DTD. Subroutines SSC and CCS are also contained 
in overlay 3PA . 
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LOCAL FILE MANAGER 



Local file management consists of a set of macros, control cards, and the PP routine 
(LFM) . The common decks required for the macros processed by LFM are COMCLFM and 
COMCSYS. LFM performs various file managing functions for a job. A description of 
each function and its macro call is available in Section 7 of the KRONOS 2 . 1 Reference 
Manual. The PP program LFM consists of a group of overlays that perform the requested 
function. The functions and their corresponding LFM overlays are outlined in Table 
10-2. 



TABLE 10-2. LFM OVERLAYS 



Code 


Function 


Overlay 


Entry Point 





Rename file 


3LB 


RNM 


1 


Assign Common file 


3LD 


ACF 


2 
3 


Enter Common file 


3LD 
3LD 


ECF 
~RCF ~~ 


Release common file 


4 


Release print file 


3LE 


RPR 


5 


Release punch file 


3LE 


RPH 


6 


Release PUNCHB file 


3LE 


RPB 


7 


Release P8 file 


3LE 


RP8 


10 


Lock file 


3LB 


LCK 


11 


Unlock file 


3 LB 


ULK 


12 


Return file status 


3LB 


RLS 


13 


Return current position 


3LB 


RCP 


14 


Request equipment 


LFM 


RQI 


15 


Assign equipment 


LFM 


AEI 


16 


Release files 


3LE 


REL 


17 


Set file ID code 


3LE 


SID 
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10.2.1 Local and Other File s 

X 7'.1» is i Election of data saved on a storage medium. It can be tape or mass storage. The 

data is written in groups of blocks or sectors, as has been shown in chapter 7. 

The system controls and designates a file by its File Name Table FNT and keeps its position by 

the File Status Table FST. 

There are basically two kinds of files. 

1 . Explicit files defined by an FNT/FST . 

2. Implicit files that are known only by a track reservation in the TRT. They are actually 
track chains and, as such, are managed by the owner. They are, more specifically, 
files unknown to the system. The best example is the Indirect PF track chain; see 
PFM in this chapter. 

This discussion will concern itself with only those files known to the system explicitly. 
These files all have an FNT/FST entry. The FST is basically used for file positioning informa- 
tion, with exceptions for Queue type files . The FNT is shown below 
42 S 6 15 



FNT* 



lfn 



job 
org 



type 



CP 
number 



If system sector 
present, bit 5 

iS-Oftr 

The FNT/FST is created for a variety of reasons. With the exception of 1TA for TELEX rollout 
files only, all files are created (i.e. , FNT/FST entry built) by the PP routine OBF begin file. 
With no exceptions, FNT/FST entries are cleared (i.e. , files dropped) by the PP routine ODF 
dropfiles, with help from OFA to release FA files, and. OPR to release DPF files and ORF to 
update RESEXDF and RESEXVF for non-allocatable files, tapes and removable packs. 
An FNT entry is considered empty if the lfn=0. When a new file is created, an empty entry is 
found and used for this new file. See the discussion on the pseudo channel FECT in Chapter 2. 
OBF will create a file with any lfn, even those consisting of special characters . Only a PP 
routine can use OBF, so a PP routine can create a file with any 1 to 7 character name. CP 
users, however, must ask CIO to create a file entry for them. CIO requires that a name be 
legal. A legal file name is composed of 1 to 7 alphanumeric characters. If CIO finds a 
special character in a file name which is to be created, he will abort the CP. However, CIO 
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will accept a file which has previously been created with an illegal name for reading, writing, 
or positioning. This allows a DMP=SEP routine to use the file DM*, which was created by 1RO. 
Once CIO has determined that the lfn is legal, it will call OBF to create the FNT/FST entry. 

The job origin field will always contain the origin code of the creator of the file, SYOT=0, 

BCOT=l, etc. 

Bit 5 is always set for RMS files, since all RMS files must contain a system sector. 

The CP number field contains the CP number of the current user of the file. If it is set to zero, 
then the file is in a Queue. 

The type field defines what type of file it is. The types will be discussed individually below. 
Refer to the example of an FNT in Chapter 2 for the following discussions . 

The FNT size can be specified at deadstart time in the CMRDECK. The default size is 1000B, 
which allows up to 400B files to be active in the system simultaneously. The entries are each 
2 words long and are numbered. These numbers are known as the FNT ordinal. The first FNT 
is ordinal and is always the file SYSTEM. FNT ordinal 1,2,3, and 4 are always created at 
deadstart time and are respectively VAUDUX, SALVARE, RESEXDF, and RESEXVF. The first 
available FNT entry then is always FNT ordinal 5. 

The type field is set up by OBF in the following manner. A table of file names is kept in OBFs 
FL. The file type is set to the corresponding file name. If the caller of OBF desires that the 
file have a file type different than OBF generates, the caller must change it himself. PFM 
will change the type to LOFT for GET command, in case the name was one of those in the OBF 
table , and will change type to PMFT or SYFT for ATTACH commands . 

The table as of Level S is at TSFN in OBF. 

lfn ^ type 

TSFN INPUT INFT 

OUTPUT PRFT 

PUNCH PHFT 

PUNCHB PHFT 

P8 PHFT 

LGO LOFT 
any other name LOFT 

1. Type INFT=0, ROFT=l, PRFT=2, PHFT=3, TEFT=4 have been extensively described in 
chapters S and 6. 
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2. Type SYFT=5. System type files are files which are used by the system for special 
functions. The 3 most famous SYFT files are VALIDUX, RESEXDF and RESEXVF which 
are created by the deadstart procedures and permanently remain at FNT ordinal 1 , 3 , 
and 4 respectively. 

These file types are changed to FAFT whenever ISF is run at a CP. If the ISF (R=lfn) 
is used, then the lfn specified if type FAFT will be changed to type SYFT, or else the 
type remains unchanged . See FAFT below. 

One other file is made SYFT if defined by PROFILE and that is the PROFILO Hie. 

3. LOFT=6. Local type files are generally scratch files. They are any file created 
locally at a CP and any indirect file retrieved by the GET command. These files are 
automatically released by 1CJ at job completion time. All tape files are also consid- 
ered local files . See FNT ordinal 7 . 

4. CMFT=7. Common files are classed into two categories . 

a) Unlocked common files are denoted by the write lockout bit set off (bit 12 which 
is really the read only bit) . See FNT ordinal 3 . 

When a user wants the use of this file, and he is validated for common files, he 
Issues the LFM command COMMON. If the file is in the Common Queue, the CP 
# field = and LFM will set it to the CP# of the caller. The caller then can read, 
write, or release the file. Only one user may use this file at a time. If the CP# 
field is not zero, the user will have to wait until it becomes available. If the 



filadoes not previously exTsT7 LFM will set the type field to CMFT. When the 
user returns the file or ends, the CP# field will be set to zero and the FNT/FST 
will not be cleared. When the user issues a RELEASE on a common file, LFM will 
set the type field to LOFT and at return or end of job, 1CJ will drop the file. 

b) Locked common files are denoted by the write lockout bit set (bit 12) . The bit is 
set by the LOCK command and unset by the UNLOCK command. However, when 
the creator of the file returns it or drops, and if the write lockout bit is set, then 
the file-can never be UNLOCKED or RELEASED, except by a level zero deadstart, 
or with the console memory entry commands . 

When a user wants the use of this type of file, he issues the COMMON command. 
LFM will find the FNT and will create a new FNT/FST for the user of type LIFT. 
This file will be in READ only mode. Many users can be reading this file 
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simultaneously, each with his own FNT/FST pointing to the same file. Of course, 
the user must be validated for common files . 

5. LIFT=10. Library files were discussed under the locked common files. The FNT/FST 
is released at return or end -of -job time, but the file space is not dropped. 

6. PTFT=11. Primary terminal files are created for the terminal user only. When he 
issues the OLD command, he is given a copy of the IPF file with PTFT type in unlocked 
mode. However, since it is an IPF, any changes he makes will not affect the original 
copy unless a REPLACE command is issued. 

When he issues the LIB command, he is requesting either an IPF or a DPF from the User 
Number LIBRARY whose UI=377776B. It is equivalent to the commands GET or ATTACH, 
pfn/UN=UBRARY. 

When he issues the NEW command, he gets a scratch file with FNT type PTFT in un- 
locked mode . 

It is important to note that the issuance of OLD, NEW or LIB will drop all files local 
to this TTY unless the NODROP command is issued immediately following . 

7. PMFT=12. When the user issues an- ATTACH command, he gets the file pointed to by 
an FNT of type PMFT. If the file is attached in read mode, then many users can each 
get an FNT of type PMFT pointing to the same file. If a user desires the file in write 
mode, he will have the only FNT pointing to the file. See the TEFT discussion in 
chapter 5 for the procedure on write mode PF attaching . 

8. FAFT=13. Fast attach files are files which have an FNT always in the FNT table. 
PFM searches the FNTs first on an ATTACH command, and if it finds it there, PFM can 
save the catalog search. See PFM for more detail on FAFT files. 

10.2.2 LFM 

LFM is a PP routine called in the manner as PFM . 

1 . A CP user can use the appropriate macro which generates an RA+1 call to LFM . 

2. A CP user can use the appropriate control card, which causes either RESEX or FILES 
to be loaded in the users FL. RESEX is loaded for the ASSIGN and REQUEST control 
card. See chapter 9 for the discussion of tape assignment. Local RMS assignment 
is the same procedure as for tape assignment. FILES will use the appropriate macro 
RENAME, COMMON, RELEASE, etc. to generate an RA+1 call to LFM. 



97404700C 10-17.4 | 



When called to a CP, LFM will locate or create the FNT/FST for the desired file. It will make 

the appropriate changes in the FNT/FST entry for the function specified in the call. LFM also 

will interface to RESEX or MAGNET if necessary. 

It is interesting to note that the routine FILES also does file skipping, rewinding and WRITER 

and WRIT5F commands. It will call CIO for these tasks . 

The terminal user must enter the BATCH subsystem in order to use the LFM functions. 
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Figure 10-10. SAVE Command Processing 
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TABLE 10-2. LFM OVERLAYS (Cont'd) 



Code 


Function 


Overlays 


Entry Point 


20 


Access library file 


LFM 


ALF 


21 


Attach control statement file 


3LF 


ACS 


22 


Enter control statement file 


3LF 


ECS 


23 


Position control statement file 


3LF 




24 


LABEL request 


LFM 


LBI 


25 


Get all local FNTs 


3LC 


GTF 


26 


Request tape assignment 


3LC 


RTA 


27 


Enter VSN entry file 


3LC 


VSN 



Overlay 3LA is the error processing overlay for LFM. All of the 3L(x) overlays are 
loaded at location OVL defined in the main LFM routine. (Currently, OVL = 1534). 

Some of the macro definitions for the above functions are in SYSTEXT, while others are 
in COMCMAC. For instance, GETFNT is defined in COMCMAC rather than in SYSTEXT 
since it is only used by the CHECKPT routine. Others defined in COMCMAC include: 
ACCSF, ENCSF, and PSCSF. All of the macros are described in the KRONOS 2.1 
Reference Manual. However, one macro, SETID, requires some additional explanation. 
This function causes the upper 6 bits of the FST entry for an existing file to be updated 
to contain the ID code specified by the macro call. The ID code is used to direct a file 
to a particular device identified with the same ID. For instance, a printer may be assigned 
an ID of 5 by the operator. This is done with the command: 

LPxx, 5. I 

where, xx is the EST ordinal of the printer . A user may specify that his output file be 
disposed to that particular line printer by use of SETID. 

An outline of the LFM memory map is given in Figure 10-11. The map represents LFM 
code prior to loading a 3L(x) overlay. 



PPFW- 



OVL 

2500 

7777 



LFM - Main Program 



Resident Subroutines 



Resident Common Decks 



Preset Routine and other 
subroutines that may be 
overlayed 



Resident Processors 



JT 



Figure 10-11. LFM Memory Map 
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The main program (LFM) calls the preset subroutine (PRS) and then jumps to the appropriate 
subroutine to process the requested function (A 3L(x) overlay is loaded, if required). 
LFM also contains the common return point, LFMX, from all function processors. 
LFMX sets the file status "not busy", completes the FET status, and drops the PP. 



The resident subroutines are called from the various function processors and include 
the following subroutines: 

CKE - Check error processing (bit 44 of FET+1) 

DEQ - drop (release) equipment 

DRF - drop file (call ODF) 

EFN - enter new file name in FNT (call OBF) 

ABT - abort job 

ERR - process error (call 3LA) 

RCL - recall LFM 

SVF - Search for VSN entry file 



Resident common decks include: 

• COMPSAF - search for assigned file 



• COMPSFB 

• COMPVFN 



set file busy 
verify file name 



The preset routine checks the input register for a valid call to LFM, determines what 
overlay is needed to process the requested function, initializes some memory cells, and 
returns to LFM (the main program) . Other subroutines, besdies PRS, that are over- 
layed include the following: 

• CRS - determine if RESEX has been called 

» TFCN - function table. Specifies the entry point address of the 
routine to process the requested function, and in which 
overlay that entry point is defined. 

Resident processing routines are those routines not requiring the loading of a special 



3L(x) overlay. 

• ALF 

• RQI 

• AEI 

• LBI 

RA+1 



Resident in LFM due to high volume use. They include: 

access library file - function 20 
request equipment - function 14. 
assign equipment - function 15. 
LABEL request - function 24. 
18 6 12 6 18 



LFM 


R 




FN 


ID 


FET Address 
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The following is a dump of various tracks and FL of the PF system: 

EXAMPLE OF PERMANENT FILES ORGANIZATION 



Foil number 

1 

So, the last track is 257, word 4373, 
byte 3. Track 260 word 4374, byte 
is the 1 st track of a Direct PF chain 
which continues on track 5 64 , word 
44 SS byte and continues on track 
565 etc. This is fee IAPF, indirect 
access PF chain. Track 261 word 4374, 
byte 1 is fee 1 st track of Permit 
information. Track 262 word 4374, byte 
2 is fee system label track. 



Description 

ABSDMP of MST/TRT for SYSTEM and PF device 
notice that track 0, the label track points to track 
237, also word 4306 says mask is 377 and bit 11 is 
off so catalog tracks not contiguous with label 
track, hence catalog tracks begin in track 237. 
Since this is an 844, DI-1 type, there are 20B 
catalog tracks . 

See system I/O section 7 for foil of label track. 

See word 4304. 

1st track of indirect PF's on track 260. Label track 
on track 0. 1st track of permit buffers is 261. 
There are 20B catalog tracks. System table track 
is 262. 

CATLIST of files for user MLO. 

DUMPTK of catalog track for user MLO, OPL, ALSON, 
USER, USERALL (See foil from MODVAL for user list). 
Also copy of MST in lower right . 

Note that this is a continuation of the Label track 
so track 237 begins in sector 0. 



user index = 2 
. track = 263. fir st sector = 4 000, indicat es that 



Description- of OPL 

Word pin = OPL 

1 . File-length =- 
this is a direct PF. 

2. Random index for permission buffer = 0, no permission creation date biased by 1970. 
June 21, 1974. 

3. The file has been accessed 36 times, modification date same as creation date. 

4. CT=2 means Public file, mode = 100 means Read permission, dn (device number) = 
means file Is on Master device (i.e., this device) last access was July 3, 1974 at 
14.42.20. 

Description of NEW070. 

This is a hole. It was a direct access file. 1st sector = 4000. Hence, when it was 

purged all tracks associated with this file were released back to the system. 

Description of MLOPL 

Word pfn = MLOPL UI = 1 

1. File length = 255 sectors, first track = 613, first sector is 27. This is an indirect 
file since bit 11 of first sector field is off. Note that each indirect PF is terminated 
by an eoi sector which is not included in the file length sector count (see FAST) 
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EXAMPLE OF PERMANENT FILES ORGANIZATION (Continued) 

2. No permission file. Created June 23, 1973. 

3. Accesses = 17, no modifications. 

4. Last access date July 3, 1974. 

CT = means private file, mode = means 

Write permission, dn=0 since this is an indirect PF and must reside on this device. 



Description of FAST 
Word 



pfn = FAST, 



UI = 1 



UI = this is a hole. 
This was an indirect PF 



1. Length = 1, 1st track = 574, 1st sector = 37, indirect PF 

2. Creation July 1, 1974. 

3. Modified July 3, 1974, accesses = 6. 

4. Last access July 3, 1974. 
Description of LGO 
Word pfn = LGO 

1. Length = 3 sectors 

2. N/A 

3. No. of accesses before purge was 2. 

4. N/A 

Note: There are 2 entries for JOKE. The first entry is a hole of 155 sectors. The second 
entry was created when JOKE was expanded to 3255 sectors and replaced. 

There is only 1 entry for JET. JET was 355 sectors and was modified to 1 sector and 
replaced. The entry for JET was used for the replace and a new hole entry was created at 
the end for the residue. 

SE = Sector number 0, 1, & 2 contain catalog entries and SE = 3 is an EOI . The System 
sector is Track 0, SE=0 since this is a part of the LABEL track chain. 

Dayfile showing PERMIT commands and alternate 
CATLIST of MLO for ALSON and for OPL and CATLIST 
of MLO. 

5. DUMPTK of catalog track for users MLO, OPL, etc. 

• Description of file POSTERS 
Word 2 random index is 1 

• Description of file SIGN 
Word 2 random index is 2 

• Description of file FAST 
Word 2 random index is 3 



see Foil 5 



see Foil 6 



see Foil 6 
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EXAMPLE OF PERMANENT FILES ORGANIZATION (Continued) 

• Description of file CMRDECK 

Word 2 random index is 4 see Foil 6 

• Description of file PW 

Word pfn = PW UI = 1 

1. Length is 255, 1st track is 703, first sector is 41, it is an indirect PF. 

2 . Random index = , no permit buffers . 

3. 4. Same as other descriptions . 

5. Password is RT. 

Note: There are all 10 word catalog buffers . Remember originally we had pfn = JET of 355 
sectors. Then we replaced it with JET of 1 sector, which created a hole of 354. Now, 
we've filled the hole with PW and have created a new hole for the residue at the end of 
the catalogs in SE = 3. So old hole of 354 sectors is reallocated as PW with 255 sectors 
of data and 1 eoi sector, plus new hole of 76 sectors. So, 255B + 1B+ 76B = 354B. 

Note that the eoi sector is now SE = 4 . 

DUMPTK of First track of permission buffers. 

• Description of sectors 
SE Description 

System sector 

1 Random index = 1 means permit buffer for pfn = POSTERS 

Word Random index for linking = 0. So all permitted users are in this sector. UI = 1, 
who owns the file 

1 . Date and time 

2. Permitted user n umbe r =JDPL, UI = 2. 

3. Accesses = 0, mode = 1 = R. 

4. Permitted user number = ALSON, UI = 3. 

5. Accesses = 1, Mode = 1 = R. 

6. Eor 

SE Description 

2 Random index = 2 means permit buffer for pfn=SIGN. 

Word no linking, UI = 1, who owns this file 

1 date and time 

2 permitted user = ALSON, UI = 3 

3 accesses = 1 , mode = 3 = E 

4 eor 
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EXAMPLE OF PERMANENT FILES ORGANIZATION (Continued) 
SE Description 

3 Random index = 3 means permit buffer for FAST 

Word 0, 1, 2 same as above 

3 mode = W 

4 eor 

4 Random index = 3 means permit buffer for CMRDECK 

Word 0, 1, 2 same as above 

3 mode = E. Note the last mode was stored. 

4 eor 

5 eoi 
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VALIDATION FILES ]] 



11.0 INTRODUCTION 

The reader must be familiar with the ACCOUNT and CHARGE cards, and the information on 
MODVAL and PROFILE in Part IV, Section 1 of the Installation Handbook. 

Validation files are used to validate users on the system. Validation defines and controls the 
following: 

1) Who can use the system 

2) What they can use (hardware and software) 

3) To what extent they can use it. 

Every user of the system (if VALIDATION is enabled) must have a valid account number. From a 
batch environment, the second card must be an ACCOUNT card. This card causes the routine 
ACCFAM to be loaded. (See Section S, number 7, "VAL=" special entry points). ACCFAM will 
access the VALIDUX file and use OAV via CPM to verify this account number. If vaiid, ACCFAM 
will set up the validation Information into the Control Point Area (CPA) and enter this Job into 
the system. 

If the CCNR (bit 7) of the access word is not set, the user must be further validated by the 
CHARGE routine. In this case, the third card must be a CHARGE card. This card causes the 
routine CHARGE to be loaded ("VAL=" SEP). CHARGE will access the PROFILO file and verify the 
CHARGE card for charge number and project number. If the user is validated, the job is entered 
into the system. 

The validation procedure allows the system to do the following. 

1 . Determine if a user should be allowed to use the system . 

2. By use of the ACCOUNT dayfile, the user can be charged for his use of the system, 

3. Each user can be validated for only certain resources, i.e. , restricted in his use of 
the system. 

4. By mapping each user onto a specific user index UI, the system can maintain PFs for 
each user, and easily control access and absolute security for each user's PFs. 
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Thus, each user is given a user number UN, which is a unique seven-character name. The UN, 
when validated, will map the user to a specific UI (usually unique, but may be duplicated by 
the staff via the FUI command at MODVAL time) . Each UI, then, will map to a specific set of 
PFs. This info is kept on the VALIDUX file which can be changed only by staff personnel at 
the system console. 

The user may be further restricted by the use of the CHARGE system. 

In this case, one user number becomes a MASTER USER (MU). The staff builds a skeleton 
PROFILO file, and the master user can access the file directly via BATCH or TTY and modify his 
charge system operation. 

For example, if the MU for charge number CN1 is UNM and he has UNI, UN2, and UN3 working 
for him, he can specify 3 projects as follows: 



cnarge 



CN1 



project number PN=PN1 



MU UN is UNM 



PN=PN2 



PN=PN3 



UNI 



UN2 

UN3 



UN3 
UNI 



This means: 

1. UNI can use PN1 or PN3 and is the only user, other than the MU, who can use PN1. 

2. UN2 can only use PN2. 

3. UN3 can use PN2 or PN3. 

4. UNM, the MU can use PN1, PN2 or PN3. 

5. All the charges will be sent to UNM who can get a breakdown of the use on these 
projects. These projects can be restricted as to time of day they can be used, etc. 

Each UN, by the way, will have his own PFs if each UN has a unique UI. If they all had the 
same UI, then they could all use the same PFs. This MU is not to be confused with the PF 
master user (see Chapter 10). If MU UN was UN* instead of UNM, this MU would also be a 
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PF master user of UNI, UN2, and UN3. To take this example even further, If UNI was the MU 
for charge CN2 and his workers were UN2, UN3 and UNM (the MU for CN1), then UNI could: 







CN 


2 




MU UN=UN1 
















1 


PN1 




PN2 


PN3 


TJ] 

TT1 


MM 

M5> 




UN3 


UN2 
UN3 



Note that in this case the project numbers are the same characters as before, but since they 
are under CN2, they are different than those under CN1. 

This means: 

1 . UNM and UN2 can use PN1 

2. UN3 is exclusive user (except for the MU) of PN2. 

3. UN2 and UN3 can use PN3 . 

4. MU UNI can use PN1, PN2, or PN3. 
Now, UNM is MU for CN1 but is a controlled user for CN2. UNI is MU for CN2, but is a 
controlled user for CN1 . 

This whole procedure allows a project to be broken into parts and to have the charges disbursed 

correctly. 

For example, if a team of programmers with a project leader is coding a system consisting of 

3 logical parts - say INPUT, PROCESSING, and OUTPUT - the project leader could get a charge 

number from the computer staff. He could then build a charging system similar to the example 

given above. Then he could tell each programmer which project number to use when on the 

system. At the completion of the project, the charges would be conveniently grouped into the 

three logical parts: INPUT, PROCESSING, and OUTPUT. 

The following discussion highlights the procedure of validating users. 

As has been shown in Figure 6-8, 1AJ, at Begin Job processing, will set the VAL= bit in the 

UTDW of the CPA if: 

1. SSTL in CMR indicates ACCOUNT enabled. (See installation Handbook, Section 5.2. 
Part II for table of ACCOUNT/VAIIDATION enabling/disabling). 

2 . Origin is BCOT or EIOT. 
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Then, IAJ loads U1DW as follows: 

12 12 

UIDW- 



12 



12 



0040 



E3 



byte 3 Is 



which is: 



0040 - Q0O 000 100 000 

Z22 211 111 111 

bit count 321 098 765 432 

1 1 
7 S 



UN=0 



+ 



UI=0 



VAL=bit 17 =ON 

Now, whenever this job is advanced, 1AI will see that the VAL= bit is on, and will abort the 
CP, unless the control card specifies VAL = SEP. 
For the flow of Validation see Appendix A 

Step # 

A. Program with a Val * SEP. 

B. Job Flow, I. Scheduler, 1 start-up. 

C. VALIDATION 



11.1 VALIDUX AND. PROFILO FILES 

VALIDUX and PROFILO are Tree File Structures (TFS) and are very similar. The 
exact format of each file is given later. These files are created by the action of MODVAL 
or PROFILE and. are writtento a file. The use of random address allows similar- levels 
to be linked, and allows a higher level to point to a lower level on the file. 

All account and charge numbers are stored on the file in alphabetical order so that a 
direct search of the file can be performed. 
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The direct search of the files uses the following method. (Figure 11-1). As each Level 

- Block is read, the Last Account Number (LAN) is compared with the Account Number 
(AC) for which this search is being made. If the LAN is less than the AC, the next level 

- block is read. In this manner, no more than one word of each Level - PRU is read 

if the AC is not on it. When the LAN is greater than or equal to the AC, the AC is compared 
with each AC from the file in backward order. When the AC from the file is again less 
than the AC for which the search is being made, there is a match. 



Level - records 



Record #1 


AA 




BB 




CC 




DD 


Record #2 


DF 




EE 




FF 




GG 


Record #3 


HE 




II 




JJ 




KK 



LINK 



LINK 



LINK 



Direct Access Files 

If one wishes to find the Level - entry 
for the account number IM, he must: 

1) Read record 1 compare 

DD< IM 

2) Read record 2 compare 

GG< IM 

3) Read record 3 compare 

KK> IM 

4) Move up the entries in record 
3 

a) JJ>IM 

b) n<IM 

The random address (RA) of this entry 
will point to the Level - 1 record with 
account number IM . 



Figure 11-1. Example of Search 

Once the Level - match is found, no more than one Level - 1 record and one Level - 2 
record will ever be necessary. (In the case of PROFILO also one Level - 3 record will 
need be read) . 
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The records are 1 PRU in length and each level is linked to all records of the same level 
(except VALIDUX where all Level - 2 records are complete within themselves). 

Level - 1 records are not normally linked . Level - records are only created during 
a create or restructure run; during updates, changes are made to Level - 1 and Level 
- 2 records only. When too many account numbers are added to one Level - 1 (Level - 
points to an overflowing Level - 1), the information overflows to a new Level - 1 record. 
In this case, the old Level - 1 record is linked to the new Level - 1 record. When this 
happens, MODVAL will issue a message to this effect to the dayfile. The user should then 
restructure the file (OP=R). 



11.2 
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11.2.1 Random Address (RA) 

An RA on a Mass Storage (MS) device is the relative PRU number from the start of the 
file. Sector on the first track is the system sector; therefore, zero is never a valid 
RA. Table 11-1 illustrates the relationship between RA and the actual disk addresses 
when writing a file consisting of 15 sectors (1 sector equals 1 PRU) using an MS with 
eight sectors-per-track. 

TABLE 11-1. RELATIONSHIP BETWEEN RA AND THE 
ACTUAL ADDRESSES 



Track Number 


Sector Number 


RA 


Description 


1 





- - 


System 


1 


1 


1 


Data 


1 


2 


2 


Data 


I 


3 


3 


Data 


1 


4 


4 


Data 


1 


5 


5 


Data 


I 


6 


6 


Data 


1 


7 


7 


Data 


2 





10 


Data 


2 


1 


11 


Data 


2 


2 


12 


Data 


2 


3 


13 


Data 


2 


4 


14 


Data 


2 


5 


15* 


EOR 


2 


6 




Open 


2 


t 




Open 



* Note that RA 15 is the EOR sector 
The common deck COMPCRA contains the routine CRA which will convert an RA to a 
track and sector address. 
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11.2.2 Linking Words (LW) 

Equal level number blocks can be linked together using the RA. If there are n Level - 
records, each Level - record can link to its successive Level - record. The last 
Level - record has the linking byte = 0. 

If, in the previous example, there were 2 Level - blocks (blocks are synonomous with 
records), 4 Level - 1 blocks, and 7 Level - 2 blocks, the relationship of RA, actual address, 
and links would be as illustrated in Table 11-2. 

TABLE 11-2. RELATIONSHIP OF RA - ACTUAL ADDRESS - LINKS 



Track Number 


Sector 


RA 


Level 


Link RA 


Description 







* — 


__ 


«... 


System 




1 


1 





2 


Data 




2 


2 








Data 




3 


3 


1 





Data 




4 


4 


1 





Data 




5 


5 


1 





Data 




6 


6 


1 





Data 




7 


7 


2 





Data 


2 





10 


2 





Data 


2 


1 


11 


2 





Data 


2 


2 


12 


2 





Data 


2 


3 


13 


2 





Data 


2 


4 


14 


2 





Data 


2 


5 


15 


2 





EOR 


2 


6 


— 


— 


-- 




2 


7 


-- 


-- 


— — 





NOTE 

On VALIDUX, Level - 2 records cannot be linked. 

Level - 1 records are linked only on overflow. 

On PROFILO, file Level - 3, which corresponds to 
VALIDUX Level - 2, can be linked on overflow. 

Table 11-3 illustrates what happens if someone updates the file and in the process needs 
to add two Level - 1 (from overflow) and four Level - 2 blocks. 
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TABLE 11 -3^ RESULTS OF UPDATE 



Track Number 


Sector 


RA 


Level 


Link RA 


Description 


1 





__ 


_ 





System 


1 


1 


1 





2 


Data 


1 


2 


2 








Data 


I 


3 


3 


I 


o 


Data 


1 


4 


4 


1 


16 


Data 


1 


5 


5 


1 





Data 


1 


6 


6 


1 


17 


Data 


1 


7 


7 


2 





Data 


2 





10 


2 





Data 


2 


1 


11 


2 





Data 


2 


2 


12 


2 





Data 


2 


3 


13 


2 





Data 


2 


4 


14 


2 





Data 


2 


5 


15 


2 





Data 


2 


6 


16 


1 





Data 


2 


7 


17 


1 





Data 


3 





20 


2 





Data 


3 


1 


21 


2 





Data 


3 


2 


22 


2 





Data 


3 


3 


23 


2 


o 


Data j 


3 


4 


24 






EOR 


3 


5 








i 



If a user number is removed from the file, the file is not restructured 
unless a MODVAL(OP=R) is used. In this case, the Level - 1 entry is 
eliminated and those below move up and the Header changes; Level - 
and Level - 2 remain unchanged. < VALIDUX flags empty entries by 
the VALINDX file) . Alphabetic order is always guaranteed even if a 
shuffling of data on the PRUs is required. 



11.2.3 AC is the account number for which the search is being made, 
account number from ACCOUNT card). 



(i.e., the 



11.2.4 DATA is the account number at the present position of the Validation file. 



11.2.5 UI is the user index 



11.2.6 CM is the central memory (60-bit words). 



11.2.7 PF is the permanent files . 
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11.3 MODVAL (VALIDUX AND VALINDX FILES) 

MODVAL provides creation, modification, and displays for the system Validation file. 
This file contains basic information necessary to validate a user's access to the system, 
and provides some controls on system resource usage. More comprehensive monitoring 
of resources can be achieved by using an additional "USER PROFILE" Validation file. 
For details refer to USER PROFILE CONTROL, Part IV, Section 1 of the Installation 
Handbook. 

MODVAL is a system utility which is used to create and maintain the special system files 
VALIDUX and VALINDX. VALIDUX is a direct access file, and VALINDX is a direct 
access permanent file which resides under user index 377777B. VALINDX contains 
a record of which user indices have been assigned, while VALIDUX contains user validation 
information, which - when referenced through an ACCOUNT card - will define the users 
permanent file index and system access permissions. The VALIDUX file is a tree-struc- 
tured file indexed by account numbers into a two level structure. A VALIDUX file is 
required for permanent file usage and one must exist for each family in the system. 
The control card call is: 

MODVAL(Pl-Fl, ...,PN=FN, . . . , PN) 

MODVAL has two other entry points which are accessed by the two controls cards: 

PASSWOR (OLDPW, NEWPW) 
LIMITS. 
The control cards are described in the KRONOS 2. 1 Reference Manual. 

Specific notes on options available are: 

1. For the C, U, R and S options, the user must supply his own files 
(VALIDUX, VALINDX), unless the user is validate to use the Force fast 
attach status (FA) parameter (OP=U, R and S). 

2 . Under the K. Z, I and L options, the system validation file is manipulated . 
K, Z and L require (SYOT) validation. 

3. When a new "VALIDUX" file is created under UI 377777B, the "ISF" 
program must be run to allow the system access to the file. 

4. To attach the "VALIDUX" file to a control point, ISF (R=VALIDUX) 
must be run to release "VALIDUX" from fast attach status. 

MODVAL will create or update the VALIDUX file either by reading a file of input data 

or by accepting commands directly from the operators console via the K display (See Section 

18, K-Display Programming). 

If a user number is deleted from the system and the UI is returned to the available 
UIs, all the permanent files associated with that UI are not automatically purged. 
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These permanent files will become available to a new user who is assigned to this m. 
The permanent files are also available to a DIS job, which uses the SUI command (see 
Operators Guide). Normally, new users are assigned UIs sequentially so UI holes would 
not be assigned unless this specific UI is specified. If a user number is going to be deleted 
from the system, it is wise that the analyst also uses the PURGALL command on this UI. 

The VA1INDX bits once set, remain set even if the corresponding UI is deleted. Only during a 
MODVA1 (OP=R) are the VALINDX bits set to zero for deleted UIs. If there are several UN with 
the same UI (via FUI command), during a MODVAL (OP=R), then the VALINDX bit stays on, even 
if some of these UN are deleted. By not turning VALINDX bits off for deleted users, MODVAL 
can guarantee that new UN will not get a previously assigned (and then deleted) UI, until a 
MODVAL (OP=R) is run. This is protection of PFs. 

■men u wi» 4.s ixiiycu nu tiuiuicis in uivij.-u anu Lhv&L-x recoras are aeietea, nowever, the 
LEVEL-2 record for this deleted user remain intact since the order of UN and UI have no bearing 
on which LEVEL-2 record will be used, this keeping of deleted users is no liability. During 
MODVAL (OP=R) these LEVEL-2 records are read and those with no LEVEL-1 pointers are 
eliminated, and if no other UN has that corresponding UI, all PFs for that UI are purged. No 
PFs are purged automatically until a restructure option is specified on MODVAL. At that time, 
MODVAL will purge all PFs assigned to any UI specified as unused in the VALIDUX file. 

The VALINDX file consists of 4210B CM words or 44 sectors, 42 Ml data sectors, 1 short EOR 
sector, and one empty EOI sector. Each bit represents one of the 377777B UIs in the system. 
If the bit is on, UI is currently active. If it is off, UI is available for assignment. 

The VALINDX file format is shown on the next page in Figure 11-2. 

When MODVAL is called to create the VALIDUX and VALINDX files it reads the input cards and 
sets up all the UIs sequentially as they are read - unless a UI is specified. In call cases, 
MODVAL creates UI = 377777B for the SXSTEM , and UI • 377776B for LIBRARY. It sets up the 
VALINDX file with the bits set for those UIs it used and the file NEWVAL (VALIDUX) with all the 
level records required. Then control is passed to the UPDATE routine. 
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53 



System. Sector 
Data Sector 1 



Data Sector 42 
Short Sector 43 
Empty Sector 44 



60 



b 



4 



EOR 
EOI 



bit 59 word of sector 1 is UI = 1 
bit word of sector 1 is UI = 60D 
bit 59 word 1 of sector 1 is UI = 6 ID 
bit word 1 of sector 1 is UI = 120D 

Figure 11-2. VALINDX File Format 
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When MODVAL is called for UPDATE, it reads the input, the VALIDUX file, and VALIDNX 
file, and changes them accordingly. Then UPDATE writes the file either as changed or 
from information supplied from the create option. 

If MODVAL is called via the K-display, any changes will cause an UPDATE. Since 
MODVAL works directly with the VALIDUX and VALINDX files, any changes are available 
as soon as K.END is typed for the entry changed. 

The VALIDUX file is a two level tree file. Figure 11-3 shows the general method of 
progression through me tree into the required file information. 



Level - 



Level - 1 
(PRIMARY) 



Level - 2 
actual data . 
records of 
validation 
information 




Figure 11-3. VALIDUX Tree File 
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The zero-level contains a fixed amount of data concerning the history of the file, and the 
first account number (and corresponding random index) of each Level - 1 block. The first 
PRU of this directory resides as sector one of the file and points to the next PRU of this 
directory. 

The next level (primary) of the tree contains all validated account numbers with corres- 
ponding random addresses pointing to the Level - 2 blocks. Level - 2 blocks contain all 
the accounting information associated with this particular account number. 

All Level - 1 records are less than one PRU in length or are linked through the control 
words if the data of a given level exceeds one PRU. Data for Level - 2 records must never 
exceed one PRU. Data in all levels is in alphabetical order (lowest item first) . All 
Level Blocks have the same header word as last word of PRU. The header format is 
shown in Figure 11-4. 



DL 


WIB 


WPE 


NOE 


FWAD 



DL = Data Level 

WIB = Words in Block 

WPE = Words Per Entry 

NOE = Number of Entries 

FWAD = First Word Address of Data 

Figure 11-4. VALIDUX, PROFILO Header Word 
Figures 11-5 through 11-8 show the format for all levels of the file. 
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Control 



DATA 1 



DATA 2 



nO 



mO 



creation 
date 



last 
MOD date 



LW = RA of next Level - block 



1st user number on this Level - 1 block * 1 



RA of above Level - 1 block 



1st user number on this Level - 1 block 



RA of above Level - 1 block 



? 



4 



DATA n 



1st user number on this Level - 1 block 



RA of above Level - 1 block 



where: 

a) Level number 

b) There are nO useful data CM words in this record exclusive of the 
3 header words (actual numeric value) 

c) There are 2 words per entry 

d) There are mO number of entries (actual numeric value) 

e) Word number 3 of the record is the 1st entry on the record. 

* Pointed by next word. 

NOTE 
The first word of the record is number 0, thus the fourth 
word of the record is really number 3. These may be short 
sectors. 



Figure 11-5. Level-0 Block Format- VALIDUX 
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Control 



DATA 1 



DATA 2 



DATA n 



a 


b 
nl 


c 
2 


d 
ml 


e 
3 





LW = RA of next Level - 1 block 


user number 


RA of the Level -2 which contains above user 


user number 


RA of the Level - 2 block for above 




• 









> 



user number 



RA of the Level - 2 block for above 



S 



where: 

a) Level number 1 

b) There are nl useful data CM words (actual numeric value) 

c) There are 2 words per entry 

d) There are ml number of entries (actual numeric value) 

e) Word number 3 of the record is the 1 st entry 

NOTE 
These are user numbers; they aren't associated 
with UI until Level - 2 . 

Figure 11-6. Level - 1 Block Format -VALIDUX 



Whereas Level-0 block was a fast index to the Level- 1 block, Level- 1 is a direct pointer 
to the Level-2 block which contains the validation information for the specified user 
number. 
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Control 



A RBI 



ARBn 



n2 



ARBS 



m2 



1st word in ARB1 block for 1st user (account) number in this 

PRU __^_______ 



S 



last word in i ARB1 block for 1st user number in this PRU 



1st word in ARBn block for nth user number in this PRU 



last word in ARBn block for nth user number in this PRU 



where: 

a) Level number 2 

b) There are n2 CM useful data words in this block 
c). Each entry (ARB) is ARBS words long 

d) There are m2(=4) entries in this block 

e) The first entry begins in word number 3 of the block 



Figure 11-7. Level -2 Block Format- VALIDUX 



Currently Accounting Record Block Size (ARBS) = 15 so only 4 ARBS will fit in each block. 
When the search gets to this Level -2 record, all the information for validation is con- 
tained in one of the 4 ARB section of this block. 
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Offset 


Tag 


ACCN 


ARBn+0 


APSW 


1 


ACCD 


2 


AAB1 


3 


AAB2 


4 


AAB3 


5 


AAB4 


6 


APJN 


7 


AHMT 


8 


AHFC 


9 


AAWC 


10 



ACCOUNT NUMBER 



PASSWORD 



11 
12 
13 
14 



RESERVED 



CREATION 
DATE 



USER INDEX 



RESERVED 



LAST CHANGE 
DATE 



ANSWER BACK CODE Number 1 



ANSWER BACK CODE Number 2 



ANSWER BACK CODE Number 3 



ANSWER BACK CODE Number 4 



PROJECT Number of Account 



MAX 
TAPES 



R 



RC 



CS 



FS 



MAX 
PACKS 



RO 



X 



TT 



MAX 
TRACKS 



PRI 



MAX 
FILES 



TIM 



MAX DEFERRED 
BATCH JOBS 



FL 



ACCESS CONTROL WORD 



RESERVED 



RESERVED 



INSTALLATION AREA 



INSTALLATION AREA 



where: 

R = Reserved for System Use . 

FC = Maximum Indirect Permanent File Count. 

CS = Maximum Total Indirect File Space. 

FS = Maximum Indirect File Size. 

P = Terminal Parity. 

RO = Number of Rubouts for Terminal User 

X = Transmission Mode. 

TT = Terminal Type. 

PRI = Maximum CPU Priority. 

TIM= Time Limit For CPU Program. 

FL = Maximum Field Length. 



Figure 11-8. Level-2 ARB Format -VALIDUX 
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The Common deck COMSACC has all the equivalences for using the VALIDUX file. The 
values are listed below for reference. 



ACCN 


EQU 





AUIN 


EQU 





' 


VFD 


42 /ACCN 




VFD 


18 /AUIN 


APSW 


EQU 


1 




VFD 


42 /APSW 




VFD 


18 /OPEN 


ACCD 


EQU 


2 


ACMD 


EQU 


2 




VFD 


24/OPEN 




VFD 


18/ACCD 




VFD 


18/ACMD 


AAB1 


EQU 


3 




VFD 


60/AAB1 


AAB2 


EQU 


4 


* 


VFD 


60/AAB2 


AAB3 


EQU 


5 




VFD 


60/AAB3 


AAB4 


EQU 


6 




VFD 


60/AAB4 


APJN 


EQU 


7 




VFD 


60/APJN 


AHMT 


EQU 


8 


AHRP 


EQU 


8 


AHMS 


EQU 


8 


AHNF 


EQU 


8 


AHDB 


EQU 


8 




VFD 


12 /AHMT 




VFD 


12 /AHRP 




VFD 


12 /AHMS 




VFD 


12 /AHNF 




VFD 


12 /AHDB 


AHFC 


EQU 


9 


AHCS 


EQU 


9 



Account number 

User index for account number 

Account number 

User index 

Password for account 

Password for account 

Coded creation date of account record 
Coded last modification date of account 

Coded creation date of account record 

Coded last modification date 

Answer back code number one 

Answer back code number one 

Answer back code number two 

Answer back number two 

Answer back code number three 

Answer back number three 

Answer back code number four 

Answer back number four 

Project number of account 

Project number of account 

Highest no. of magnetic tapes allowed 

Highest number of removable packs allowed 

Highest number mass storage 
tracks allowed 

Highest number working files allowed 

Highest number deferred batch jobs 
allowed 

Highest number of magnetic tapes 

Highest number of removable packs 

Highest number of mass storage tracks 

Highest number of working files 

Highest number of deferred batch jobs 

Highest number of indirect permanent 
files 

Highest number of indirect file 
sectors 
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AHFS 



EQU 



ATPA 


EQU 


9 


ATRO 


EQU 


9 


ATPX 


EQU 


9 


ATTT 


EQU 


9 


AHPC 


EQU 


9 


AHTL 


EQU 


9 


AHFL 


EQU 


9 




VFD 


3/ RESERVED 




VFD 


3/AHFC 



VFD 





VFD 




VFD 


APAE 


EQU 


APAO 


EQU 


APAMX 


EQU 




VFD 


A ROSY 


EQU 




VFD 


APXH 


EQU 


APXF 


EQU 


APXMX 


EQU 




VFD 


ATTY 


EQU 


ATTC 


EQU 


ATTCA 


EQU 


ATTMA 


EQU 


ATTMX 


EQU 




VFD 




VFD 




VFD 



3/AHCS 

3/AHFS 
1/ATPA 


1 
2 

5/ATRO 



37B 

1/ATPX 


1 
2 
5/ATTT 


1 
2 

3 

4 

12 /AHPC 

12 /AHTL 

12/AHFL 



Highest number of sectors for one U 
file 

Terminal parity 

Terminal rubouts 

Transmission mode 

Terminal type 

Highest priority for CPU allowed 

Highest time limit allowed 

Highest field length allowed in units 
of 100B octal words 



Highest number of indirect permanent 
files 

Highest number of indirect file 
sectors 

Highest number of sectors for IA files 

Terminal parity - may contain the 
following values: 

Even parity 

Odd parity 

(maximum number of values) 

Terminal rubouts 

ins tOixOwing value uaS speciax 
meaning: 

Use system default for terminal type 

Transmission mode - may contain 
the following values: 

Half duplex 

Full duplex 

(maximum number of values) 

Terminal type - may contain the follow- 
ing values : 

ASCII compatible terminal (TTY) 

Correspondence terminal 

Correspondence, with APL character 
set 

MEMOREX, with APL character set 

(maximum number of values) 

Highest priority for CPU 

Highest time limit 

Highest field length in 100B word 
units 
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AACW 



DUMMA1 



DUMMA2 



DUMMA3 



DUMMA4 



AUIMX 





APFN 




AUFN 


Octal 

Value 




7 


AINC 


20 


.ANCR 


1 


AINW 


17 


ARBS 


4 


ARBB 


2 


ANWE 



EQU 


10 


ACCESS C 


ONTRO 


VFD 


24/0 


VFD 


26/0 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


VFD 


1/1 


EQU 


11 



VFD 
EQU 
VFD 
EQU 
VFD 
EQU 
VFD 
EQU 

MICRO 
MICRO 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



Access control word 

Installation area bits 
System reserved 

* CSTP* user special transaction 
privileges 

* CSRP* user may mount removable 
devices 

* CCNR* user may run without charge 
number 

* CAND* user assignment of non-alloc 
EQ 

* CASF* user access to system files 

* CSOJ* user can have system 
orgin, if debug 

* CSPF* user can create indirect 
access file 

* CLPF* user can create direct 
access file 

* CTPC* user can use telex privileged 
CMDS 

* CPWC* user can change his password 



60 /RESERVED FOR SYSTEM USE 

12 

60 /RESERVED FOR SYSTEM USE 

13 

60 /INSTALLATION AREA 

14 

60 /INSTALLATION AREA 



377700B 



Maximum UI for legal login or account 
card 



1, , VALIDUX Account validation file name 
1, , VALINDX Available user index file name 



7 Account number length in characters 

AINC+9 Rounded account number length 

.ANCR/ 10 Account number length in CM words 

15 Account record block size in CM words 

64/ARBS Account records in Level-2 data block 

AINW+1 Account number words /entry 
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36 


.ANPB 


34 


ANLC 


70 


ABLI 



74 



ABLB 



EQU 

EQU 
EQU 

EQU 



64/ANWE-2 Account number entries /blocks 
,ANPB/ARBB*ARBB Less conrrol words 



ANLC* ANWE 
ARBS*ARBB 



Words per index block less 
control words 

Words per data block less control 
words 



OAV is used by ACCFAM to locate the UI of a user number. Figure 11-9, the flow chart 
of OAV shows how the tree files are used to locate an entry. 

Basically, the Level-0 block is searched until the Account Number (AC) wanted is 
greater than the account number on the file (DATA). When this condition is found the RA 
of the last DATA points to the LEVEL - 1 block needed, (i.e. 1st DATA on RA n-1 > 
AC > 1st DATA on RA n, then LEVEL- 1 block is RA n-1). 

The Level-1 block is searched until DATA=AC, then RA points to the Level-2 record. 

The Level-2 block is searched until the account number field = AC, then this ARB is the 
information record (4 per Level-2 block). The password is then checked and UI is set 
accordingly. If, during the search, no match is found or some LINK RA is fradulent, 
UI is set to 0. 



VUN - Main Program 




Entry: Validation file attached 

Exit: Tl. T2 = UI if found 

T1.T2 = if not found 
(A) - UI 



Figure 11-9. A V Verify user Number 
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* 1 IVF - initialize validation file 

ENTRY: (CN, . . . , CN+3) = Family name 

= if no family name 

EXIT: <T4) = channel 

(T5) = equipment 

(T6) = first track 

(T7) = first sector 

(FTOV) = first track 

channel will be reserved, file will be set busy 

(A) = if file unavailable 

Figure 11-9. OAV Verify User Number (Continued) 




SIB 



Search Index 
Block 
Level- 



position disk' 

to Level- 1 

Block 



Entry: Validation file attached 
(UN, . ..UN+3)=user 
number 





Figure 11-10. SUN - Search for User Number 
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release 
VALIDUX 
file 




yea 



/can find 

.„ ( account 

\ number 



* 4 



Set 
(T2) = UI 

(A);UI 



/ Return J 



Figure 11-10. SUN - Search For User Number (Continued) 
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* 2 RNS - read next sector is a common deck 

COMPRNS. 

ENTRY: (A) = address of PP buffer 

(T4) = channel 

(T5) = e quipment 

(T6) = track 

(T7) = sector 

channel reserved, disk positioned 
EXIT: (A) = (Tl) = word count of sector 

(T3) = address of PP buffer 

(T6 - T7) = advanced if no eoi 

NOTE 
It is known that this Level -2 record exists because if it did not, 
SIB would have returned (A)< for a bad index. 

* 3 instruction AOM SUNB will modify instruction SUNB LDN 

NJN SUN 6 IF HIT 



to SUN LDN 

NJN 



SUN6 IF HIT 



* 4 Search Level-2 block for user and verify user for password number. 
If valid, set (A) = user index (UI). If not valid, set (A) = 




/ RNS 
(read next 
\ sector 



Entry: (FTDV) = First track 
disk positioned 
(T6) = Track number 
(T7) = Sector number 
channel attached 

Exit: (A)<0 if error (can't find 
entry) 
(A)£ if no error 



Read 

1st DATA 
from Block 



Figure 11-11. SIB - Search Index Block 



11-20 



97404700B 



Definitions: 

AC = account number searching for 

□ATA = account number we found on file 

Dashed lines indicate difference between Level-0 and Level- 1 search 



LEVEL- 1 




read 
next DATA 




SIB 

.4 _ 



,np 



yes 



Match is DATA = AC 
] 



SIB 



SIB 
YY 



r" 



Read 

last DATA 
from Block 



LEVEL-0 




yes- 




SIB 



Read 

next DATA 

(up the file) 




Match is DATA > AC 




Figure 11-11. SIB - Search Block (Continued) 
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*5 



Found a Match: 

IF LEVEL-0 search then get 
RA of LEVEL -1 block 

IF LEVEL- 1 search then get 
RA of LEVEL-2 block 



* 5 *5.CRA from common deck COMPCRA will convert random ad- 
dress (RA) to track and sector number. 

ENTRY: (T5) - equipment number 

(T6) = first track of file 

(RI.RI+1) = RA 

EXIT: (A)<0 if address out of bounds (i.e. not on the 

track chain) 

(T6) = track number 

(T7) = sector number 



NOTE 

CRA must have the equipment number of the device to determine how 
many sectors per device . 



Figure 11-11. SIB - Search Index Block (Continued) 

11.4 PROFILE (PROFILO FILE) 

PROFILE provides creation, modification and displays for the project profile file PROFILO. 

PROFILE is a system utility which is used to create and maintain the special system file 
"PROFILO". PROFILO is a direct access permanent file residing under user index 
377777B. PROFILO contains the information required to control a user's access to the 
system. The access is defined by charge, project, and user numbers, with additional 
limits on time-of-day and accumulated machine usage. The user is required to supply 
correct charge and account numbers if the"CCNR" bit in the users access word is clear. 
PROFILE also allows the definition of a master user for a charge number. This master 
user is validated to add or delete project numbers, account numbers, and user access 
information under the specified charge number. This modification to the charge number 
may be done under batch operation or from a TTY. A PROFILO file must exist for each 
permanent file family in the system, when this facility is desired. The PROFILE control 
card is: 
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PROFILE (Pl-Fl, . . . , PN=FN, FM) 

The control card is defined in the KRONOS 2. 1 Reference Manual. Specific notes on the 
use of available options are: 

1. When a new "PROFILO" file is generated under UI 377777B, ISF must be run 

bU V-i ^OH* Cb tO-Ol. atbCk^ii J. - if J. CUH j 4Ui. uK iuC j 

2. To attach the "PROFILO" file to a control point, ISF (R=PROFILO) must be. 
run to release "PROFILO" from fast attach status. 

3. When running PROFILE (OP=R) restructure file, the FNT entry for the fast 
attach file will be cleared. ISF must be run to reset an FNT entry. 

11.4.1 P ROFILO File Structure 

The PROFILO file is a 3-ievei, tree -structured file and is accessed in the same manner as 
the VALIDUXfile. 

The PROFILO file can be updated either from the operators' console, batch or TTY. 

The Level-0 contains a fixed amount of data concerning the history of the file, and the 
first charge number (and corresponding random index) of each Level- 1 block. (Figure 
11-12). The first PRU of this directory resides as Sector 1 of the file and points to the 
next PRU of this directory. 

The next level (primary) of the tree contains all validated charge numbers with corres- 
ponding random addresses pointing to the Level-2 blocks. 

A record in Level-2 of the tree contains all valid project numbers for the corresponding 
charge number. Along with each project number is a random address pointing to the 
Level- 3 blocks. 

Level-3 blocks contain all project profile information associated with this particular 
charge number and project number. 

All records are less than one PRU in length and are linked through the control words if 
the data of a given level exceeds one PRU, with the exception that Level-3 records 
consisting of more than 1 PRU of data are on continuous PRUs. Data in all levels is in 
alphabetical order (lowest item first). 
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Level -0 

(index to Level- 1 charge 

numbers) 



Level- 1 

(charge numbers and 

master user) 

PRIMARY 



Level -2 
project numbers 



Level- 3 • 
(project 
number infor- 
mation and user 
numbers allowed 
under them) 




Figure 11-12. PROFILO Tree File Structure 
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Figures 11-13 through 11-16 give the format for the PROFILO file. 



Controls 



DATA 1 



DATA n 



a 1 b 
| nO 


c 
2 


d 
mO 


e 
3 





CREATION 
DATE 


LAST MOD 
DATE 


LW = RA of next Level-0 record 


1st charge number in this Level- 1 block 


RA of above Level- 1 block 



1st charge number in this Level- 1 block 



RA of above Level- 1 block 



Where: 

a) Level number 

b) There are nO useful words in this block not counting 
the three header words 



c) There are two words per entry 

d) There are mO entries in this block 

e) Word number 3 is the 1st entry 



Figure 11-13. Level-0 Block - PROFILO 
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Control 
DATA 1 



DATA n 



nl 



ml 



LW = RA of next Level- 1 block 



charge number 



master user number (ACCOUNT card user number) 



? 



RA of Level -2 block for this charge number 



* 1 



? 



charge number 



master user number 



RA of Level -2 block for this charge number 



Where: 

a) Level number 1 

b) There are nl words of useful data in this block 

c) There are 3 words per entry 

d) There are ml entries in this block 

e) The 3rd word is the 1st entry 

* 1 This associates the charge number with the master users UI 



Figure 11-14. Level- 1 Block - PROFILO 
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Control 



DATA n 



n2 



m2 



LW = RA of next Level- 2 for this charge number 



Project number part 1 



Project number part 2 



RA of Level-3 block for this project number 



<> 






*1 



? 



Project number part 1 



Project number part 2 



IA of Level-3 block for this project number 



Each charge number has one or more Level-2 blocks associated with it. 
However, project numbers for only one charge number may reside in 
any one block. The charge number is not repeated since Level- 1 points 
us to this block, so we know what charge number is associated with it. 

* 1 If the project number is less than 10 characters, then this word 
is zero. 



Figure 11-15. Level-2 Block - PROFILO 
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RRPN 

PRCD 

PRTI 

PRCP 

PRAP 

PRCT 

PRAT 



PRUN 



3 n3 

Project number part 1 



n3 



PRUN 



Project number part 2 











CREATION DATE LAST MOD DATE 



TIME IN 



TIME OFF 



Maximum accumulated CPU time 



Accumulated CPU time 



Maximum accumulated connect time 



Accumulated connect time 



Open 



Open 



Open 



Open 



Open 



<^ 



User number 1 validated for this 
project number 



* 1 



* 3 



* A 



? 



User number n-1 





User number n 






a) Level number 3 

b) There are n3 usable data words in this block 

c) There are n3 data words in this entry (i.e. one entry per block). 

d) There is one entry in this block. 

e) The first user number is at word PRUN. 

* 1 User mav only use the svstem during the hours specified. As an example, if we 

set Time" In (TI) to 08.00.00 and Time Off (TO) to 15.00.00, then this user can 
only run between 8 am and 3 pm. 

Note 
Level- 3 records are not actually linked, but if they overflow they are written or. 
successive PRUs. A PRUN user number of zero will end this Level-3 chain. 

* 2 When PRAP is greater than PRCP user is no longer allowed to run. 

* 3 When PRAT is greater than PRCT user is no longer allowed to run. 

Note 
PRAP and PRAT are not updated by the system as of release level 1. 
If the master user wishes to keep the users on this project number from running 
on the system, he must set PRAP and /or PRAT in the PROFILO file. See 
the Installation Handbook for details on this procedure. 

* 4 PRUN is the start of a list of all user numbers (account # from VALIDUX file) 

which are validated for this project number. Permanent files are assigned 
by the UI for this user number. 

Figure 11-16. Level-3 Block - PROFILO 



11-28 



97404700A 



i i . 4. 2 Equivalence Values For PROFILO FILE 

- RrpTiT7Sletir»ia -trainee: fr\r* nae w-i+>i +>»o PPO^TT f"* file *3T»p a-^aila^lo in *>»*a c*-. 

COMSPRO. A list of this equivalence is included here for reference. 



<_•!.! U1~ ^_j£ 



Octal 
Value 



3 

4 

4 
5 
6 

7 

10 

16 

12 

23 

24 

35 

1 

2 

13 

2 

3 

3 

40 
25 
25 
36 

24 

24 
74 

74 

74 



Tag_ 

PRMU 

PRPN 

PRCD 
PRTI 

PRTO 
PKCP 
PRAP 

PRCT 

PRAT 

PRUN 

CINC 

.C 

P1NC 

,P 

CINW 

PINW 

CBNW 

CNWE 

CMWE 

PNWE 

CNPP 
CMPP 
PNPP 
CNLC 
CMLC 

PNLC 
CBLP 

CMLP 

PBLP 

PFFN 

PPWD 
PUSN 



EQU 

EQU 

EQU 
EQU 

EQU 
EQU 
EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 
EQU 
EQU 
EQU 
EQU 

EQU 
EQU 
EQU 

EQU 

EQU 

MICRO 

MICRO 

MICRO 



Description 

1 Master user number 

I Project number 

3 Creation and modification dates 

4 Time in 

4 Time off 

5 Maximum accumulated CP time 

6 Accumulated CP time 

7 Maximum connect time 

8 Accumulated connect time 
14 First user number 

10 Charge number length in characters 

CINC-i-9 Rounded charge number length 

20 Project number length in characters 

PINC+9 Rounded project number length 

. C! 10 Charge number length in CM words 

. P/ 10 Project number length in CM words 

II Profile control block length in CM words 
CINW+1 Charge number words /entry 

CNWE+1 Charge number + master U.N. words /entry 

PINW+1 Project number words/entry 

64/ CNWE Charge number entries per PRU 

64/ CMWE Charge number + master U.N. entries /PRU 

64/ PNWE Project number entries per PRU 

CNPP-2 Entries per PRU - control words 

CMP P-1 Entrie s per PRU - control words 



64 /PNWE 
PNPP-1 

CNLC* 

CNWE 

CMLC* 
CMWE 

PNLC* 
PNWE 

1, , * PRO- 
FILO* 

1. . * SE- 
CURUS* 

1, . * SYS- 

TEMX* 



Protect number entries per PRU 
Entries per PRU - control words 
Charge number block length per PRU 

Charge number + master U.N. block length/ 
PRU 

Project number block leneth Der PRU 



PROFILO permanent file password 
PROFILO permanent file user number 
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Octal 
Value 


Tag 






6 


TOPT 


EQU 


6 


7 


LOPT 


EQU 


7 


001 


BUFL 


EQU 


1001B 


101 


PBUFL 


EQU 


10 IB 


12 


.CPB1 


EQU 


CNLC/3 


6 


.CMB1 


EQU 


CMLC/3 


6 


.PPB1 


EQU 


PNLC/3 


24 


.CPB2 


EQU 


CNLC-.CPB1 


16 


.CMB2 


EQU 


CMLC-.CMB1 


16 


.PPB2 


EQU 


PNLC-.PPB1 


50 


CPBP 


EQU 


. CPB2* CNWE 


52 


CMPB 


EQU 


.CMB2*CMWE 


52 


PPBP 


EQU 


. PPB2* PNWE 



Description 

Time -sharing update option 
List option 
Input buffer length 
PROFILO buffer length 



Charge number partial block length 

Charge number + master U.N. 
partial block 

Project number partial block length 
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The following is a dump of some MODVAL output and the VALIDUX, VALINDX files. 



TABLE 11-4, MODVAL, VALIDUX, VALINDX 



Foil No. 



1 & 2 



SE 



N/A 



Description 



Listing of active users during a series of 
creating and deleting of user numbers . 

DUMPTK of track number 264, which is the 
VALIDUX file. 

LEVEL - is 5 words in length . 3 header words 
and one DATA set since there is only 1 LEVEL- 1 
record. ALSON is the first user number | 

alphabetically and the LEVEL - 1 record pointed 
to is RA = 3 . 

LIBRARY and SYSTEM are created first, then 
MLO and OPL were created. This is a LEVEL- 
record. 



LEVEL-1 record is 45B words long, since there 
are 17D = 22B active users. 
Note: in the margins is indicated where words 
are zero and therefore non-existent in the dump, 
hence each sector has a 3 word header and j 
each sector is a short sector, i.e., an EOR. The 
squared UN points to LEVEL-2 RA=4 on this ■ I 
slide. ALSON, USER, and USERALL are active J 
however, there is no pointer for DUMMY since 
it has been deleted. 

This is a LEVEL-2 record. UN=ALSON UI=3 , 
PW=ALSON See Figure 11-8 KRONOS 2.1 
WORKSHOP manual for detail of the rest of 
this Account Record Block (ARB) UN=USER, UI=4, 
PW=N/A. UN=USERALL, UI=S , PW=USERALL. 
The last ARB has been deleted, hence the 
LEVEL-1 sector may be changed, but this ARB 
is not changed until a MODVAL (OP=R) is 
executed. 

EOI sector 

This is the VALINDX file. 
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TABLE 11-4. MODVAL, VALIDUX, VALINDX (Continued) 



Foil No. 


SE 


Description 


7 
7 


1 
44 


The maximum UI used except for 377777B and 
377776B is 50D = 62B, so only used 1st word. 
However, notice that all 44 sectors are 
allocated and are full sectors. 111=377777 and 
377776 are not represented in VALINDX. This 
1st word is shown on slide 7, 

Breakdown of 1st word of VALINDX file 
representing UI=1 thru 60D. 

EOI sector. 
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-<1 



O 



MODVALIOPmL.LO.NI 



74/07/18. 12. OS. 43. 



ACCOUNT 


USER 


CREATION 


LAST MOD 


NUMBER 


INOFX 


DATE 


DATE 


MLO 


1 


74/06/17. 


74/07/01 


OPL 


2 


74/06/17. 


74/06/17 


ALSON 


3 


73/06/19. 


73/06/19 


USER 


4 


73/06/19. 


73/06/19 


USERALL 


S 


73/06/19. 


73/06/19 


OUMMT 


6 


74/07/1S. 


74/07/18 


OUHMVl 


7 


74/07/18. 


74/07/18 


0UMM2 


10 


74/07/lB. 


74/07/18 


LIBRARY 


377776 


74/06/17. 


74/06/17 


SVSTEMX 


377777 


74/06/17. 


74/06/17 



& 





MOOVALIOP 


■L.LO.NI 


74/07/18. 12.06.4S 


ACCOUNT 
NUMBER 


USER 
INDEX 


CHEA7ION 
DATE 


LAST MOD 

OAIt 


MLO 

OPL 

ALSON 

USER 

USERAiL 

DUHH2 

LIBRARY 

SYSTEMX 


1 
S 

3 

4 

5 

10 

377776 

377777 


74/06/17. 
74/06/17. 
73/06/19. 
73/06/19. 
73/06/19. 
74/07/18. 
74/06/17. 
74/06/17. 


74/07/01. /^T\ 

74/06/17. ID J 

73/06/19. VZ^ 

73/06/19. 

73/06/19. 

74/07/18. 

74/06/17. 

74/06/17. 



MODVAL<OP»L.LO.N) 



ACCOUNT 
NUMBER 

MLO 
' OPL 
ALSON 
USER 
UStRALL 
DUMM2 
STUPIO 
HIGH 
LIBRARY 
SVSTEMX 



74/07/lE 



USER 
INDEX 



CREATION 
DATE 



LAST HOC) 
DATE 



1 74/06/17, 74/07/01. 

2 74/06/17. 74/06/17, 

3 73/06/19. 73/06/19, 

4 73/06/19. 73/06/19, 

5 73/06/19. 7J/0O/19. 

10 74/07/18. 74/07/18, 

11 74/07/18. 74/07/18. 
50 74/07/18, 74/07/18, 

377776 74/06/17, 74/06/17. 

377777 74/06/17, 74/0o/n. 



o 
J» 

o 
o 

o 





modvaliop 


•I ,LO«Nl 


74/07/18. 12.08.57 


ACCOUNT 


USER 


CREATION 


LAST MOO 




NUMBER 


INDFX 


DATE 


OA'E 




■4|_0 


1 


74/06/17 


. T4/0'/01. 




IPL 


2 


74/(|6/|7 


. 74/06/17. 




OLSON 


3 


73/06/19 


. 73/06/19. " •£_ 




USER 


4 


73/06/19 


. 73/06/19. f2E) 




USEB»LL 


5 


73/0»/l» 


, 73/06/19, I JJ 




0UM.M2 


10 


74/07/18 


. 74/07/18, \^S 




STUPln 


11 


74/07/18 


. 74/07/JB. 




ONE 


12 


74/07/IB 


, 74/07/18. 




TWO 


13 


74/<>7/18 


, 74/07/18. 




THREE 


14 


74/07/18 


, 74/07/18. 




"IBM 


SO 


74/07/18 


, 74/0'/|8, 




SIXTY 


60 


74/07/18 


. 74/0 7/18.. 




LIBRARY 


37?m 


74/06/17 


, 74/06/17, 




SYSTEMX 


377777 


74/06/17 


, 74/06/17, 






MOOVAL (OP* 


L.LO.N) 


74/07/18. 12.09 


SI. 


ACCOUNT 


USER 


CREATION 


LAST MOD 




NUMBER 


INDFX 


OATE 


OATE 




MI.0 


1 


74/06/17. 


74/07/01. 




OPL 


2 


74/06/17. 


74/06/17. jS\ 




ALSON 


3 


73/06/19. 


73/06/19. |i»/ 
73/06/19. y ^ 




USER 


* 


73/66/19, 




U5EPALL 


5 


73/06/19. 


73/06/19. 




0UMM2 


10 


74/i>7/lB, 


74/0'/l8. 




stupid 


11 


74/07/18. 


74/07/1B, 




ONE 


12 


74/07/IB. 


74/07/18. 




Two 


13 


74/J7/IB. 


74/07/18, 




MI«M 


50 


7«/n7/10. 


74/07/1B. 




library 


37777ft 


7*/06/l7. 


74/06/17. 




SYSTEMX 


377777 


7*/06/l7. 


74/06/17, 






MOOVAL 1 OP- 


L,LO»N> 


74/07/18. 12.11 


04. 


ACCOUNT 


USER 


CREATION 


LAST MOD 




NUMRER 


INDEX 


OATE 


DATE 




MLO 


1 


74/06/17. 


74/0'/0t. 




O^L 


2 


74/06/17. 


74/06/17. 




ALSON 


3 


73/06/19. 


73/06/19. 




USER 


4 


73/06/19, 


73/06/19. , . 




UStRAlL 


5 


73/06/19. 


T3/06/19. iQ 




DIJMM? 


10 


74/07/IB. 


74/of/ie. \j/ 




stupid 


11 


74/07/18. 


74/o'/ie. 




O'lE 


1? 


74/(17/18. 


74/07/18. 




TWO 


13 


74/07/18. 


74/0T/1B. 




FOUR 


15 


74/07/18, 


74/0'/18. 




FIVE 


It. 


74/07/18. 


74/07/18. 




SIK 


17 


74/07/18. 


74/0'/l8. 




S^VEN 


20 


74/07/18, 


74/0//16. 




HJGM 


SO 


74/07/18. 


74/07/18, 




SIXTY! 


61 


74/07/18, 


74/0'/l8. 




LIHWAPr 


377776 


T»/0»/17. 


74/06/17. 




SYSTEMX 


377777 


74/06/17. 


74/06/17, 





-J 

o 

O 

o 
O 



\Jt\L-lX><J* 



0UHPTKCTK»2fc4l 

uOnO TK»264 SE«0 81-3777 B2«77 

2t>011411042S3oo01300 YALlOUX K 

1 0000*26*11*4171)13303 7»I»OA0C 

2 000000000*07221*040* D8RLDU 
71261405*00)30033201 *VLt£AXCZA 
340230*005155*00707* 1BXSEM. »-. 
30*312773)0160033*05 XBJIY»=CIE 
30071003160660*00313 XGHCNFxSCK 
1*0*5*00707637020603 t0« t-.»BFC 

10 26011*110*2330377777 VALlD»x*ll 

11 010600000002*26**000 AE 87*5 

12 000000000*062110*6*5 0FQH-* 

13 00000000030701131300 CGAKH 
000000000*062110*6*5 DF0H-* 

15 00000000000000000000 

16 00000000000000003303 0C 

17 ooooooooooooOooooooo 

20 70760510301*0*0*1070 ♦-EMXLDOMt 
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LOADER 12 



12.0 INTRODUCTION 

There are actually two loaders. One is a PP routine, LDR, (also called LDV) which is 
an absolute CM routine loader. This LDR loads absolute binaries directly from the 
RCL or directly from the system RMS device, or from a local file. The second loader 
is the relocating loader, LINK. LINK takes a relocatable type binary deck and absolutizes 
it at whatever location in a CP's CM desired. 

For completeness, the PP loader and Alternate System Residency lASR) are mentioned 
here. The PP routine loader, PLL, is discussed in Section 4, and ASR is discussed 
in this section. 

The basic flow of loading central memory programs is detailed in Section 8 of the KRONOS 
2. 1 Reference Manual. All the loader table formats are presented in Appendix D of the 
Reference Manual. Subsequent discussions in this section are a supplement to the 
KRONOS 2.1 Reference Manual. 

The Loaders can be called in the following ways. 

1) A control card call, LOAD 

2) A control card, such as COMPASS, LGO, etc. 

3) An RA+1 call to LDR to process overlay loading (overlays are always absolute 
routines) . 

12 . 1 LDR (LDV) 

The LDR call is shown in Figure 12 - 1 . 

LDR Calls from CPU Routine 
RA+1 



LDR 


R- 





addr 



R - auto recall if desired 
addr -address of request 



Figure 12-1. LDR Call 
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The load request consisting of 2 or 4 words is shown in Figure 12-2. 



addr+O 

addr+1 
addr+2 
addr+3 



NAME 





..:*.. 


...5.. 


J2 


3 


i 


1 


4 


1 


18 


18 


Ll 


L2 


N 1 





U 


V 





E 


r LWA 


FWA 




OVLNAME 





EPTNAME 






No. of Bits 
Name 



NAME 

Ll 

L2 

N 

U 

V 

E 

FWA 

LWA 

OVLNAME 

EPTNAME 



Source of name depending on U and N . 

First overlay level . 

Second overlay level. 

Number of words in request - 2 . 

Load option (see below). 

Overlay flag (Must be set to 1) . 

Call completion flag (see below) . 

First word address of overlay. 

Last word address available for load 

Name of overlay to be loaded (if N/0) . 

Entry point name when loading multiple entry 

point overlay (if N=2). 



Note. 

If TJ=0, N is ignored and NAME is the name of the file containing 
the overlay. (Ll and L2 are required). 

If U=l and N=0, NAME is the name of the overlay from the system, 
(Ll and L2 are ignored) . 

If U=l and N^O, OVLNAME is the name of the overlay from system 
(Ll and L2 are ignored). 

If FWA=0, Overlay is loaded at address specified by overlay. 

If L1=L2=0, Control is to called overlay, otherwise, control is 
returned to caller with FWA = entry address. 

If E = l, Control transfers to the specified entry point (EPTNAME) 
in the overlay. 



Figure 12-2. Load Request 
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Upon completion of the load, information is returned in the call block shown in Figure 
12-3. 



addr+O 
addr+1 

addr+2 
addr+3 



18 



NAME 





6 
LI 


6 
L2 


12 



EPTADDR 


OVLNAME 





EPTNAME 






where : 

EPTADDR - Entry point address of overlay 

If N=2 

EPTADDR = Address of EPTNAME 

Figure 12-3. Load Completion Call Block 

Dayfile messages associated with Figure 12-3 include: 

1. OVERLAY NOT FOUND IN LIBRARY - Requested overlay was not found in the 

system library. 

2. ARG ERROR - LDR parameters were outside FL. 

3. FILE NOT OVERLAY FORMAT - First record of file was not an overlay. 

4. LDR ERROR - Issued before one of preceding errors. I 

LDR will load its copy routines from 1A J overlay 3AE . These are a group of subroutines 
used to load CM-programs which consist of: 

1. LCP - Load Central Program 

2. CMS - Copy Mass Storage-resident program 

3 . SLP - Set load parameters 

4. CSF - Check Special Format (ACPM) 

5. CCM - Load (ECS) resident programs CASR) 

6. Several format checking routines (ACPM Table) 

LDR will then check for proper argument program load not out of bound, etc.) and load 
the program or overlay. When completed, LDR drops and, if recall was used, CPUMTR 
will let the caller continue. A flowchart of the Loader loop is shown in Figure 12-4. 

NOTE: 
LDR automatically starts a (0,0) level overlay regardless of the instructions 
specified in the LDR control block. For this reason, if a (0,0) level overlay is 
to be loaded, but not started automatically, the user can use a READSKP or 
READR CIO request. A (0,0) overlay load is enterpreted by LDR as a request to 
overlay the caller of LDR. 
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Main Flow 



EXECUTE 

3AE 
Load COPY 
, ROUTINES 



Check 
Request 
Address 



* 1 





Yes /LDR\ 
.2-5 



Read 
OVERLAY 
ENTRY 

Name 



*4 




OVERLAY 
NOT FOUND 
IN LIBRARY 




* 1 is lower 18 bits of RA+1 call out of users FL. 
*2 is location to load program out of users FL. 

* 3 this is not an OVERLAY call. 

* 4 get word 3 & 4 of call . 

* 5 Common deck COMPCLD. 



Figure 12-4. LDR - ABS, COS, and OVL Loader 
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/ 



© 



Main Flow 



EXECUTE 



\ * 1 



' 3AD 

process 
S, file 
\ search 







Set entry 
address in 
user reply 
word 



FTN 



drop PP 
DPPM 



IpprJ 



TldeJ 



FTN 



abort 

CP 

ABTM 



PPR 



* 1 3AE and SAD reside in core with LDR. See 1AJ overlay core layout in Section 6. 

3AD uses common decks COMPSAF- search for assigned file and COMPSFB- 
set file busy. 3AD searches Library for the load name. 

* 2 This check is actually performed in overlay 3AD 

* 3 In overlay 3AE . 

* 4 or a main routine . 



Figure 12-4. LDR - ABS, COS, and OVL Loader (continued) 
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12.2 LINK (RELOCATABLE LOADER) 

LDR will load LINK at RA + 100. LINK will process the binary file and begin building an 
absolute deck relocated from RA + 100 (or other load address if specified) at the end of the 
code. Link will build reference tables and any other tables needed at the end of the user's 
FL. The program will grow downward and tables will grow upward. If they meet, the FL 
is too small to load the routine (See Figure 12-5). In the last 20D words of FL there is a 
small move and preset routine. LINK will build the absolute program unitl it reaches 
EOR on the file . Then it will use the tables it built to satisfy all local transfers . It 
then reads the next routine on the file, loading it behind the previous one. When LINK 
finally encounters an EOF or EOI on the file, it attempts to link all the loaded routines 
together and satisfy all external references from any libraries specified. If undefined 
external references remain, it links them to an object time routine LDRUSX, which will 
abort the control point if called. 

If the execution flag is set (LGO card EXECUTE card, etc. ), LINK will transfer to the 
last 20 locations in this F . This small routine will move the absolute code produced by 
LINK to its load point (normally RA + 100). If Preset is selected, core is set and control 
is transferred to the transfer address specified in the transfer table, XFER. In addition 
if the execution flag is not set, LINK will read the next control card. If it is not one of 
its control cards, it will go inactive, and 1AJ will reprocess the control card. 

The control cards LINK processes are: 



1. 


LDSET 


2. 


LOAD 


3. 


MAP 


4. 


NOMAP 


5. 


LIBRARY 


6. 


REDUCE 


7. 


SETCORE 



In addition, for debug purposes the console operator under the DIS package can type 
RSS.LGO (if the binaries exist on LGO, if not, any lfn can be used). This command will 
force LINK to load the binaries in the usual manner and set P = transfer address from the 
XFER table. It will also execute the move and preset core loop, but the loaded routine 
will not be put into execution. The move loop will drop the CPU and the operator may 
break point. 
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RA 



RA+100 



RA+IOOB+Length of 

LINK 



e 



RA+FL-20D 
RA+FL 



Communication Area 
(See Sec. 2) 



LINK Binaries 



Absolute Relocated Program 
Binaries 



Loader Tables 



Move and Preset Routine 






Figure 12-5. Core Layout of LINK 
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If the control card which forces a call to LINK, is an LGO relocatable type program call. 
LDR will find that the binary deck is relocatable (either a 70-LDSET or 34-PIDL type 
table follows the 77-IDENT type table). It will load the overlays as shown in Figure 12-6 
(level- 1) and set the Execution Flag (XF) On. LDR will set (P)="LDR=". LINK will then 
begin processing the binary file. 

If the control card which forces a call to LINK is a LDSET, LOAD, CARD, etc., LDR 
will simply load the overlay, LINKCTL, and will set (P)=control card name. LINKCTL 
will process the card. If the card was an EXECUTE card, then LINK will have LDR= loaded, 
set the execution flag, XF, On, and go to CPL. Each card has its own entry point. 

If LDR= detects an OVERLAY directive in the binary, it will have OVG= overlay loaded 
and will let OVG= process these binaries. The OVERLAY directive must be the 1st card 
of the overlay, otherwise the load is aborted. If the control card call was a LIBGEN 
card, LDR loads just the overlay, LIBGEN, as shown in Figure 12-6 (level -2) and will 
set (P)- LIBGEN. 

If the control card call was a LINK card, the overlay, LINKLNK, is loaded and (P)=LINK 
is set as shown in Figure 12-6 (Level -3). 

All of the tables generated and used by the loader are dynamic and controlled by the use 
of three macros and their associated routines. 

1. ADDWRD and ADW - add 1 word to managed table. 

2. SCAN and STE - scan table for entry. 

3. ALLOC and ATS - allocate table space. 

NOTE 

Similar table management macros can be found 
in the Common Deck COMCMTM and the asso- 
ciated routines are in the Common Deck COM- 
CIUTP. Also reference Appendix A of the 
KRONOS 2. 1 Reference Manual. 

In addition, one other macro, TABLE is used to generate a managed table. 

By using these macros, all the tables will expand and contract without consciencious effort 
of the code of LINK which uses them. 

Figure 12-7 flowcharts the general flow in level- 1. 
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RA 
RA+100 

n* .111 



RA+3122 
RA+3171 
RA+3202 



RA +3400 



RA+40 67 



RA+5226 
RA+6257 



RA+7720 



Level 1 

SYSTEM 
Communication Region 

Table Space 



Level 2 



Level 3 



LDR= 

Relocatable 
Loader 



INL Initialize 
Code 



LINKCTL 
(Control Card 
Processing) 
LDSET 
LOAD 
MAP 
NOMAP 
LIBRARY 
KJiDUCi; 
SETCORE 



MAP = 
Write Load Map 



OVG = 

Overlay 

Generator 

(generate 

absolute 

overlays) 



LIBGEN 
LINKLIB 

Generate 

User 

Libraries 



LINK 

LINKLNK 



"rn-*ei c a 



LINK 
Control Card 



Figure 12-6. LINK Overlay Core Structure 
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LDR loads LINK and the transfer table specifies LDR= as entry point. First executable 
code for LINK. 



© — 



INL 



Initialize 
Load 




Get Load 
File Name 
From (RA+64) 



Set 
Execution 
Flag-— EX 



Enter Load 
File Name 
TLFN 



T.HF 



Load File 




(ACTR) 



CPL) Complete Load 



Processes the Loading cf 
Relocatable Programs 



Figure 12-7. LINK Flow In Level- 1 
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COMPLETE LOAD 



Enter System 

Library 

Name 

— *-TLFN 



LIB 
Process 
Libraries 



AL = Alternate Library 

SL = System Library 

FE = Fatal Errors 

B = Binary Requested 



Satisfy External 
References from 
User Libraries 



USX 
Process Un- 
satisfied 
externals 



Link Remaining 
Unsatisfied Externals 
to LDRUSX 



<SXP 
Set 
Execution 
Parameters/ 



FBC 

Fill Byte 
Chains 



XFBC 
Fill 
Extended 
Sv te Chains 

sag*- 



MLD 
Process 
Load Map 



Set Blank Common Origin, 
Execution Fl, and Set 
XFER Address 



Fill Common Block 
References use FILL 
and XFILL tables ref 
manual D-13 




CPF 

Complete 

Files 



/ 

Check TLFN 
&. return ap- 
propriate 
Files back, 
to the 
system 

Figure 12-7. 




LINK Flow in Level -1 (Continued 
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EXECUTE PROGRAM 



(AO) = FL 




Overlay 
(DPBA) 




Initialize PGM 
Move Downward - i.e ., re- 
locate program 
Move Downward Loop to End 
of TPGM Table (end of FL) 



Initialize Execution Constants 
i 



Set 
FWA & LWA 
of PGM Load 



-i- 



Set Argument 
Count & Copy- 
Sense Switches 



X 



Clear LDR 
Control Word 
& RA+1 



I 



Copy 

Arguments 
--*-RA+2 with- 
in TPGM 



Copy Ctl. 
Card - •*- 
RA-70B within 
TPGM 



RA+2 
thru 
RA+64 
and 
RA+70 




Clear 
lemory 



No- 
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Set FWA 
of Memory 
to Clear 



B5 



Set FL 

- ■*- B7 
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FL 
.Reductior 



nr 



TPGM Link 
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building the 
absolute 
binaries for 
the program. 



Move PGM 
Down Loop 
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DOWN LOOP 
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FL 
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package . 
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Figure 12-7. LINK Flow in Level- 1 (Continued) 
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INITIALIZE LOAD 



"FL Too 
Short for 
Loader'' 



— *(abt) 



Set Map 
Options- - 
& Reduce 
Flag 



MP 



-»-EF 




Set Alter- 
nate Library 
Name - -*-AL 



Initialize 

I/O 
Buffers 



Set up FET 
for I/O 



Initialize Managed Tables (At this point memory is preset if a SETCORE 
JL — — -^ card preceded the load) 



APS 



TPGM 



Initialize 
- -*- ORGP 
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Will contain TEXT 
images of loaded program. 



EBP 



Enter Block 
Common Bloc! 
irith Length 



EBP 



Enter System 

. Block with / 
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Set Blank 
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System Block 
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Figure 12-7. LINK Flow in Level- 1 (Continued) 
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LOAD FILE 
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Process 

LDSET 
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exists 




Initiate 
Read READNS 
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Read 1st 
Word READW 
lfn, Tl, 1 
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Load File 



Read to EOF 

(See if everything in file) 



Move 1 word from buffer to 
working storage area 




EOF 
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"Load File 
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/Read/RDR 
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TLNK 



Figure 12-7. LINK Flow in Level- 1 (Continued) 
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[rdrJ 

lRDR2^ ] < 



Extract Table 
Code & Word 
Count from 
Binary Deck 
Table 



READ RECORD 



Examine Table Code and Branch to Table 
Processor 




V_ 



Force an 
Error Jump 



Table Processors 



All processors except 
code 50, 51, 53 will 
return at this point. 

Table Processor Return 



READW 



77 - 


IDENT 


- IDT 


70 - 


LDSET 


- LDSET 


51 - 


ABS 


- OVL 


50 - 


OVL 


- OVL 


53 - 


OVL/ECS 


- OVL 


46 - 


XFER 


- XFER 


47 - 


XREPL 


- XREPL 


44 - 


LINK 


- LINK 


45 - 


XLINK 


- XLINK 


43 - 


REPL 


- REPL 


42 - 


FILL 


- FILL 


41 - 


XFILL 


- XFILL 


40 - 


TEXT 


- TEXT 


37 - 


XTEXT 


- XTEXT 


36 - 


ENTR 


- ENTR 


34 - 


PIDL 


- PIDL 
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Control Word 




EOF > No 

Yes 



"*{g> 



Return 
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Any Other - CKD 



Loader Directive for Unidentified Table Header 



Note 

OVL will make RA+1 request for LDR to make an 
absolute load. 



Figure 12-7. LINK Flow in Level- 1 (Continued) 
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12.3 ALTERNATE SYSTEM RESIDENCY (ASR) 

This feature allows moving selected portions of the operating system to non-system mass 
storage. Only program types OVL, ABS, and PP can be used. The program(s) are placed 
on the specified device after stripping off the 77 table. Accordingly, the PLD/CLD 
(Peripheral Library Directory/ Central Library Directory) is set up to assure use of the 
alternate copy of a routine . 

A primary area for use of this capability is high access routines. This places them on a 
device which has access /transfer rates superior to that of the system device. In addition, 
if ECS/DDP is available, PP routines which would normally be CM resident could be 
moved, thus freeing up CM. ECS resident CPU code is loaded directly by central monitor 
rather than passing through 1AJ. With the DDP option, a PP routine load may progress 
directly from ECS into PP core and execute. This obviates the need to shuttle the code 
from ECS to CM to PP core. 

Alternate system devices are defined at deadstart (CMRDECK time) with the entry 

ASR = £,, E„, . . . , E . 
1 I n 

Where E is the equipment ordinal. This causes a flag to be set in the appropriate MST. 
Alternate devices must be mass storage, ECS, non- system, non- removable, and may not 
be equipment . 

The LIBDECK directive to SYSEDIT for specifying routines for a particular device is 
*AD,E,ty 1 /REC 1 ,ty 9 /REC 9 , ty /REC 

E selects the device and may be either an equipment ordinal or device mnemonic. In 
the latter case, the first alternate device of this type will be used. The record type is 
specified by "ty " and "REC " is the record name. Only one alternate device per routine 
is allowed. 

The alternate PP library directory resides at the beginning of the PLD. This forces PP 
resident to check alternate libraries first, and also provides a mechanism for quickly 
disabling access to them. The PLD entry pointing at the SYSTEM copy is not removed. 
A pointer to the start of the SYSTEM PLD is maintained in low CM. Alternate device CPU 
routines are flagged by placing the equipment number in word one of the CLD entry. 
Word two contains track and sector for both alternate and system copies (See Figure 2-21). 

An unrecoverable error while attempting to load a PP routine from an alternate device will 
cause all PP accesses to revert to the system device. This is accomplished by rewriting 
the PLD pointer (PLDP) to point at the SYSTEM copy entries. Errors encountered while 
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loading a CPU program will cause access to the alternate copy of the program to be 
disabled. 

12.4 LOADER AND LOADER TABLES 

When using a product set such as FTN, COBOL, etc., the product will put all the library- 
names it needs into the LDSET table of the binary deck, so that it is no longer necessary 
to put a library name in the LDCW word of the CPA . 

A partial list of some product libraries follow: 



Library Name 

SYSLIB 

RUN2P3 

BASLIB 

COBOL 

FORTRAN 

SIMLIB 

SYSIO 



Product Set 

Default for system 

RUN 2.3 

BcLsic 

COBOL/ SORT 4.0 

FTN 4.0 

SIMULA 

6RM object time routine 



It is important to ensure that all libraries on the system are updated to the same PSR 
level, as some libraries will make reference to other libraries (FORTRAN to SYSIO). 
If the two libraries are at different levels, they may not be compatible. 

When using an ACPM table (5300), after a load, LINK will load the LWA of the largest 
overlay of the program (or this one if just an ABS deck) into RA X FWAS (normal default is 
100) of the F . (Figure 12-8). Figure 12-10 is an example of user libraries. The user 
can use this to dynamically control buffers. Buffers can be started at this address and 
will never need to be moved or overlayed. 



ACPM 



5300 


h 


h 


FWAS 





entry 




fwal 


= 


wcl = 


endl = 


ends 


= LWA 


WCSO 











No ECS words 



where FWAS = Address in CM to load FWA of largest overlay 
entry = Address of entry point into this largest overlay 
ends = LWA of largest overlay 



Figure 12-8. ACPM Table 



9T404700A 



19- ' 



There are three ways to defeat the automatic field reduction after a load. 

1. Use the control card REDUCE (-) 

2. Have an external reference to the name LOADER. 

Any external reference to LOADER in a routine will allow the 
CP to keep all of the FL it currently has instead of the automatic 
reduce to FL needed for load. To accomplish this, inlcude any code 

like the following. 



EXT 

SA1 

etc. 



LOADER 
=XLOADER 



3. RFL= Only used by LDR for absolute type CP loads. 

The following paragraphs describe the general format for a binary deck table. All the 
binary deck tables are shown in Appendix D, KRONOS 2. 1 Reference Manual. 

In order to be externally compatible with SCOPE versions of COMPASS and other language 
translators, KRONOS subscribes to the SCOPE relocatable subroutine format. Hence, the 
logical record of output (subroutine) consists of an indefinite number of tables. Each table 
in this appendix is a subdivision of a logical record . 

The first word of each table identifies the table to the system. That is, it indicates the 
kind of information that the table contains. ■ The format of the identification word is shown 
in Figure 12-9 and the parameters are listed in Table 12-1. 



59 



53 47 



35 



26 



17 



cn 


W/A 


words 


W///A 


reloc 


address 



Figure 12-9. Identification Word 



12.5 PRINTOUT EXAMPLES 



Figure 12-10 is an example of User Libraries. 

Figure 12-11 is an example of a FORTRAN deck with LDSET. 

Figure 12-12 is an example of XFILL, XLINK Tables. 

Figure 12-13 is an example of Overlay generation with an ACPM table. 

Figure 12-14 is an example of an Absolute Deck 

(LDSET Table not currently generated by COMPASS). 
Figure 12-15 is an example of a Relocatable Program. 

(LDSET Table not currently generated by COMPASS) , 
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TABLE 12-1. IDENTIFICATION WORD PARAMETERS 



Code Number 
(en) 


Table 


reloc 


address 


words 


34 


Identification 
and Length 


iiWt W.t3©V-A 


n 


J.1SLU..LIUCF ui WOFQb 

in table (not 
counting 
identification 
word) 


36 


Entry Point 


not used 


not used 




40 


Text 


reloc =0, relative 
to RA 

to program 
origin 

reloc=3-77 , rela- 
tive to labeled 
common block 
M, where M is 
in position LR- 
2 of LCT 


load 
address 


42 


Fill 


j 


43 


Replication j not used 


not used 


44 


Link J not used 





46 


Transfer 1 not used 


not used 


77 


Prefix ! not used 


not used 
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>-" Program 

f 1 

to 

o 



TRACY 



COMPASS3. 73130 





I 
3 
4 
5 
10 



7110000005 
0100000000 
0400000000 



05162405220504552422 



43100 





IDENT 


TRACY 




ENTRY 


TRACY1 


TKACY1 


BSSZ 


1 




MESSAGE 


MESS1, , R 




RJ 


=XPAUL1 




EQ 


TRACY1 


ME SSI 


DIS 

END 


, /ENTERED TRACY, CALL PAUL/ 



STORAGE USED 
MODEL 74 ASSEMBLY 



12 STATEMENTS 
0.061 SECONDS 



73/08/07.12,54,51. PAGE 2 
USSK LI8RAKY: PDTLIB 

Tr* e y ends' 
Pa.* I Cal/s 
Karl 
en J 



4 SYMBOLS 

7 REFERENCES 




1 
3 
4- 



1 TAMMY1 



7110000004 + 
0400000000 + 
05162405220504552401 

43100 



MESS2 



[DENT 

ENTRY 

BSSZ 

MESSAGE 

EQ 

DIS 

END 



STORAGE USED 
MODEL 74 ASSEMBLY 



TAMMY 

TAMMY1 

1 

MESS2..R 

TAMMY1 

, /ENTERED TAMMY, RETURN BONNIE/ 



eallr .CauI c » 
calls- tCari "* 



11 STATEMENTS 
0.059 SECONDS 



3 SYMBOLS 

6 REFERENCES 



CD 
O 

-J 
o 

o 









IDENT 


TRINA 








ENTRY 


TRINA 1 





1 


TKINA1 


BSSZ 


1 


1 


7110000004 + 




MESSAGE 


MESS3, , R 


3 


0400000000 + 




EQ 


TRINA 1 


4 


05162405220504552422 


MESS3 


DIS 


, /ENTERED TRINA, RETURN BONNIE/ 


7 






END 






43100 


STORAGE 


USED 


11 STATEMENTS 






MODEL 74 ASSEMBLY 


0.059 SECONDS 








IDENT 


PAUL 








ENTRY 


PAUL1 





1 


PAUL1 


BSSZ 


1 


1 


7110000007 + 




MESSAGE 


MESS4, , R 


3 


0100000000 X 




RJ 


-XKARIl 


4 


7110000012 + 




MESSAGE 


MESS44, , R 


6 


0400000000 + 




EQ 


PAUL1 


7 


05162405220504552001 


MESS4 


DIS 


, /ENTERED PAUL. CALL KARI/ 


12 


22052425221655200125 


MESS44 


DIS 


, /RETURN PAUL, RETURN TRACY/ 


15 






END 
Figure 12-10. 


User Libraries 



3 SYMBOLS 

6 REFERENCES 



Program TRACY 



o 
o 

8 



43100 



7110000004 + 
0400000000 + 
05162405225513012211 

43100 



STORAGE USED 
MODEL 74 ASSEMBLY 



1 KARI1 



MESS5 



STORAGE USED 
MODEL 74 ASSEMBLY 



COMPASS 3:73130 

10 STATEMENTS 
.075 SECONDS 



IDENT 


KARI 


ENTRY 


KARI1 


BSSZ 


1 


MESSAGE 


MESS5, , R 


EQ 


KARI1 


DIS 


, /ENTER KARI, RETURN PAUL/ 


END 





11 STATEMENTS 
0.059 SECONDS 



73/08/07.12.54,51 PAGE 2 

5 SYMBOLS 
10 REFERENCES 



3 SYMBOLS 

6 REFERENCES 




1 
3 
4 
10 



1 TERRY1 



7U0000004 + 
0400000000 + 
05162405220504552405 

43100 



IDENT 

ENTRY 

BSSZ 

MESSAGE 

EQ 

DIS 

END 

STORAGE USED 
MODEL 74 ASSEMBLY 



Ml 



TERRY 

TERRY1 

1 

M1..R 

TERRY1 

. /ENTERED TERRY, RETURN TO CALLER/ 



11 STATEMENTS 
0.034 SECONDS 



3 SYMBOLS 

6 REFERENCES 



JOBOAIG. 73/08/07, BAR ILAN UNIVERSITY. 

12, 54, 50, JOB, T7777. OM60000 . 

12,54, 50. ACCOUNT(YP) 

12, 54, 50, COMPASS(B=BINARY) 

12,54,51, ASSEMBLY COMPLETE. 44000B SCM USED. 

12,54,51, 0.442 CPU SECONDS ASSEMBLY TIME . 

12, 54, 51, DEFINE (DDTLIB) ,,- -^. 

12, 54, 52, LIBGEN(E=BINARY, N = DDTLIB, P = DDTLIB6nXpO).' 

12. 54. 52, LIBRARY GENERATION COMPLETE. 

12, 54, 52, REWIND (ThDDTiLIB) 

12, 54. 52. TDUMP(T = DDTLIB, 0) 

12. 54, 53. CP 0.532 SEC. 

12.54. 53. CM 0.003 KHH. 

12.54. 53. MS 0.077 KPR. 

12.55. 18, LP 0.300 KLN. 



Gen er*.te / a Orors rffe***c <t 
/,'rf tn-fwe.e.1 til fl-iyra-tr. r. 



Figure 12-10. User Libraries (continued) 











TDUMP of USER LIBRARY 














A more readable format starts on p. 12-23.1. 




F 


1 R 


1 W 


0- 


77 00 00 16 0000 0000 0000' 


0404 2414 1102 0000 0000 


5542 3650 3344 5033 4257 


0000 0000 0000 0000 0000 


F 


1 R 


1 W 


4- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


__ 


ABOVE LINE REP RATED -- 






MUUB 


F 


1 It 


1 W 


14- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


<70DO 0000 0000 0000 0000 


F 


1 It 


1 W 


20- 


2422 0103 3134 0000 0000 


4000 0000 0000 ,0000 0002 


*4000 0000 0000 0000 0005 < 


"4000 0000 0000 0000 000G 


F 


1 It 


1 W 


24- 


2401 1515 3134 0000 0000 


4000 0000 0000 0000 0003 


2422 1116 0134 0000 0000 


4000 0000 0000 0000 0000 


F 


1 R 


1 W 


30- 


2001 2514 3400 0000 0000 


4000 0000 0000 0000 0005 


*4000 0000 0000 0000 0006 


1301 2211 3400 0000 0000 


F 


1 It 


1 W 


34- 


4000 0000 0000 0000 000G 


2405 2222 3134 0000 0000 


4000 0000 0000 0000 0007 


* = > EXTERNAL 


-- 


END OF RECORD -- 






REFER 


F 


1 R 


2 W 


0- 


7700 0016 0000 0000 0000 


2422 0103 3100 0000 0000 


4236 5033 4450 3342 5755 


3435 5740 3757 4034 5755 


F 


1 R 


2 W 


4- 


2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 


F 


1 R 


2 W 


10- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


F 


I R 


2 W 


14- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 


F 


1 R 


2 W 


20- 


2422 0103 3100 0000 0010 


3600 0002 0000 0000 0000 


2422 0103 3134 0000 0000 


0000 0000 0000 0100 0000 


F 


1 R 


2 W 


24- 


4000 0010 0000 0100 0001 


4000 4000 0000 0000 0000 


7110 0000 0571 6020 0000 


0100 0000 0061 0004 6000 


F 


1 R 


2 W 


30- 


0100 0000 0061 0004 6000 


0400 0000 0061 0004 6000 


0516 2405 2205 0455 2422 


0103 3156 5303 0114 1455 


F 


1 R 


2 W 


34- 


2001 2514 0000 0000 0000 


4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


F 


1 R 


2 W 


40- 


4400 0004 0000 0000 0000 


2001 2514 3400 0000 0000 


6001 0000 0300 0000 0000 


1523 0754 0000 0000 0000 


F 


1 R 


2 W 


44- 


6001 0000 0200 0000 0000 








-- 


END OF RECORD -- 








F 


1 R 


3 W 


0- 


7700 0016 0000 0000 0000 


2401 1515 3100 0000 0000 


4236 5033 4450 3342 5755 


3435 5740 3757 4034 5755 


F 


1 R 


3 W 


4- 


2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 


F 


1 R 


3 W 


10- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


F 


1 R 


3 W 


14- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 


F 


1 R 


3 W 


20- 


2401 1515 3100 0000 0007 


3G00 0002 0000 0000 0000 


2401 1515 3134 0000 0000 


0000 0000 0000 0100 0000 


F 


1 R 


3 W 


24- 


4000 0007 0000 0100 0001 


4010 0000 0000 0000 0000 


7110 0000 0471 6020 0000 


0100 0000 0051 0004 5000 


F 


1 R 


3 W 


30- 


0100 0000 0061 0004 G000 


051G 2405 2205 0455 2401 


1515 3156 5522 0524 2522 


1655 0217 1616 1105 0000 


F 


1 R 


3 W 


34- 


4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


4400 0002 0000 0000 0000 


F 


1 R 


3 W 


40- 


1523 0754 0000 0000 0000 


6001 0000 0200 0000 0000 






-- 


END OF RECORD -- 








F 


1 R 


4 W 


0- 


7700 0016 0000 0000 0000 


2422 1116 0100 0000 0000 


4236 5033 4450 3342 5755 


3435 5740 3757 4034 5755 


F 


1 R 


4 W 


4- 


2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 


F 


1 R 


4 W 


10- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


F 


1 R 


4 W 


14- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 


F 


1 R 


4 W 


20- 


2422 1116 0100 0000 0007 


3600 0002 0000 0000 0000 


2422 1116 0134 0000 0000 


0000 0000 0000 0100 0000 


F 


1 R 


4 W 


24- 


4000 0007 0000 0100 0001 


4010 0000 0000 0000 0000 


7110 0000 0471 6020 0000 


0100 0000 0051 0004 6000 


F 


1 R 


4 W 


30- 


0400 0000 0061 0004 6000 


0516 2405 2205 0455 2422 


1116 0156 5522 0524 2522 


1655 0217 1616 1 105 0000 


F 


1 R 


4 W 


34- 


4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


4400 0002 0000 0000 0000 


F 


1 R 


4 W 


40- 


1523 0754 0000 0000 0000 


6001 0000 0800 0000 0000 







END OF RECORD 



O 



Figure 12-10. User Libraries (continued) 



CO 


F 


1 R 


5 W 0- 7700 0016 0000 0000 0000 


2001 2514 0000 0000 0000 


4236 5033 4450 3342 5755 


3435 5740 3757 4074 5755 


-J 


F 


1 R 


5 W 4- 2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 


o 

it* 


F 


1 R 


5 W 10- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


i 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


-1 


F 


1 R 


5 W 14- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 


§ 


F 


1 R 


5 W 20- 2001 2514 0000 0000 0015 


3600 0002 0000 0000 0000 


2001 2514 34000000 0000 


0000 0000 0000 0100 0000 


> 


F 


1 R 


5 W 24- 4000 0015 0000 0100 0001 


4000 4010 0000 0000 0000 


7110 0000 0771 6020 0000 


0100 0000 0061 0004 6000 




F 


1 R 


5 W 30- 0100 0000 0061 0004 6000 


7110 0000 1271 6020 0000 


0100 0000 0061 0004 6000 


0400 0000 0061 0004 6000 




F 


1 R 


5 W 34- 0616 2405 2205 0455 2001 


2514 5603 0114 1455 1301 


2211 0000 0000 0000 0000 


2205 2425 2216 5520 0125 




F 


1 R 


5 W 40- 1456 5522 0524 2522 1655 


2422 0103 3100 0000 0000 


4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 




F 


I R 


5 W 44- 0000 0000 0000 0000 0000 


4400 0004 0000 0000 0000 


1301 2211 3400 0000 0000 


6001 0000 0300 0000 0000 




F 


1 R 


5 W 50- 1523 2754 0000 0000 0000 


6001 0000 0260 0100 0005 








-- 


END OF RECORD — 










F 


1 R 


6 W 0- 7700 0016 0000 0000 0000 


1301 2211 0000 0000 0000 


4236 5033 4450 3342 5755 


3435 5740 3757 4034 5755 




F 


1 R 


6 W 4- 2303 1720 0555 3557 3355 


0317 1520 0123 2355 2657 


4236 3536 3355 5555 5555 


5555 5555 5555 5555 5555 




F 


1 R 


6 W 10- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 




F 


1 R 


6 W 14- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 




F 


1 R 


6 W 20- 2001 2514 0000 0000 0015 


3600 0002 0000 0000 0000 


1301 2211 3400 0000 0000 


0000 0000 0000 0100 0000 




F 


1 R 


6 W 24- 4000 0007 0000 0100 0001 


4010 0000 0000 0000 0000 


7110 0000 0471 6020 0000 


0100 0000 0061 0004 6000 




F 


1 R 


6 W 30- 0400 0000 0061 0004 6000 


0516 2405 2255 1301 2211 


5655 2205 2425 2216 5520 


0125 1400 0000 0000 0000 




F 


1 R 


6 W 34- 4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


4400 0002 0000 0000 0000 




F 


1 R 


6 W 40- 1523 0754 0000 0000 0000 


6001 0000 0200 0000 0000 








-- 


END OF RECORD -- 










F 


1 R 


7W 0-7700 0016 0000 0000 0000 


2405 2222 3100 0000 0000 


4236 5033 4450 3342 5756 


3435 5740 3757 4034 5755 




F 


1 R 


7 W 4- 2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 




F 


1 R 


7 W 10- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 




F 


1 R 


7 W 14- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


3400 0001 0000 0000 0000 




F 


1 R 


7 W 20- 2405 2222 3100 0000 0010 


3600 0002 0000 0000 0000 


2405 2222 3134 0000 0000 


0000 0000 0000 0100 0000 




F 


1 R 


7 W 24- 4000 00 10 0000 0100 0001 


4010 0000 0000 0000 0000 


7110 0000 0471 6020 0000 


0100 0000 0061 0004 6000 




F 


1 R 


7 W 30- 0400 0000 0061 0004 6000 


0516 2405 2205 0455 2405 


2222 3156 5522 0524 2522 


1655 2417 5503 0114 1405 




F 


1 R 


7 W 34- 2200 0000 0000 0000 0000 


4000 0002 0000 0100 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 




F 


1 R 


7 W 40- 4400 0002 0000 0000 0000 


1523 1754 0000 0000 0000 


6001 0000 0200 0000 0000 






-- 


END OF RECORD -- 










F 


1 R 10 W 0-7700 0016 0000 0000 0000 


0404 2414 1102 0000 0000 


5542 3630 3344 5033 4257 


0000 0000 0000 0000 0000 




F 


1 R 10 W 4- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 




-- 


ABOVE LINE REPEATED — 






©00 0000 0000 0000 0016 




F 


1 R 


10 W 14- 0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 




F 


1 R 


10 W 20- 0404 2414 1102 0000 0005 


0000 0000 0000 0000 0001 


2422 0103 3100 0000 0003 


0000 0000 0000 0000 0002 




F 


1 R 


10 W 24- 2401 1515 3100 0000 0003 


0000 0000 0000 0000 0003 


2422 1116 0100 0000 0003 


0000 0000 0000 0000 0004 




F 


1 R 


10W 30-20012514 0000 0000 0003 


0000 0000 0000 0000 0005 


1301 2211 0000 0000 0003 


0000 0000 0000 0000 0006 




F 


1 R 


10 W 34- 2405 2222 3100 0000 0003 


0000 0000 0000 0000 0007 






to 


-- 


END OF RECORD -- 








1 
to 


— 


END OF FILE -- 








w 


-- 


END OF INFORMATION — 
END OF DUMP -- 









Figure 12-10. User Libraries (continued) 



This is a copy of the dump on p. 12-22 and 12-23 in a more readable format. 

USER LIBRARY EXAMPLE 
DDTUB 



Record I - 

77000016000000000000 
04042414110200000000 
554236503344S0304257 
00000000000000000000 
00000000000000000000 
00000000000000000000 
90000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
76000000000000000000 
24220103313400000000 
40000000000000000002 

* 40000000000000000005 

* 40000000000000000006 
24011515313400000000 
40000000000000000003 
24221116013400000000 
40000000000000000004 
20012514340000000000 
40000000000000000005 

* 40000000000000000006 
13012211340000000000 
40000000000000000006 
24052222313400000000 
40000000000000000007 



LABEL HEADER 

DDTUB 

73/09/07 



UHB HEADER 

TRACY1 

code In record 2 

extern reference to PAUL I in rec 5 

extern ref to KARI1 from PAUL1 in rec 6 

TAMMY1 

code in rec 3 

TRINA1 

code in rec 4 

PAUU 

code in rec 5 compare to TRACY1 extern 

extern ref to KARI1 in rec 6 

KARI1 

code in rec 6 

TERRY1 

code in rec 7 



♦indicates external reference 



| 12-23.1 



97404700C 



USER LIBRARY STRUCTURE 



Record 2 



Record 3 



77000016000000000000 
24220103310000000000 
33365035355042355547 
33335733425734405755 
23031720055536573755 
03171520012323553657 
42343543365555555555 
55555555555555555555 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
TRACY 34000001000000000000 
24220103310000000010 
36000002000000000000 
24220103313400000000 
00000000000001000000 
40000010000001000001 
10004000000000000000 
43601206277110000005 
01000000006100046000 
01000000006100046000 
04000000006100046000 
05162405220504552422 
01033156550301141455 
20012514000000000000 
40000002000001000000 
00000000000000000000 
00000000000000000000 
44000004000000000000 
20012514340000000000 
60010000030000000000 
15230754000000000000 
60010000020000000000 



77000016000000000000 
24011515310000000000 
33365053535504235547 
33335733425734405755 
23031720055536573755 
03171520012323553657 
42343543365555555555 
5555S55555555555555S 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
TAMMY 34000001000000000000 
24011515310000000007 
36000002000000000000 
24011515313400000000 
00000000000001000000 
40000007000001000001 
10100000000000000000 
43601206277110000004 
01000000006100046000 
04000000006100046000 
05162405220504552401 
15162405220504552401 
16550217161611050000 
40000002000001000000 
00000000000000000000 
00000000000000000000 
44000002000000000000 
15230754000000000000 
60010000020000000000 



97404700C 



12-23.2 | 



Record 4 



Record S 



77000016000000000000 
24221116010000000000 
3336503S3SS042355547 
3333S73342S73440S744 
23G3I7ZG055536573755 
03171520012323553657 
42343543365555555555 
55555555555555555555 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 

oooooooooooooooooooo 

00000000000000000000 
34000001000000000000 
TRINA 24221116010000000007 
36000002000000000000 
24221116013400000000 
00000000000001000000 
40000007000001000001 
10100000000000000000 
436012062771 1Q0Q0004 
01000000006100046000 
04000000006100046000 
05162405220504552422 
11160156552205242522 
16550217161611050000 
40000002000001000000 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
44000002000000000000 
15230754000000000000 
60010000020000000000 



77000016000000000000 
20012514000000000000 
33365035355042355547 
33335733425734415755 
23031720055536573755 
03171S20012323553657 
42343543365555555555 
5555555555555555SS55 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
0000000000000000000" 
34000001000000000000 
PAUL 20012514000000000015 
36000002000000000000 
2001251434000000O000 
00000000000001000000 
40000015000001000001 
10001010000000000000 
43601206277110000007 
01000000006100046000 
01000000006100046000 
43601206277110000012 
01000000006100046000 
04000000006100046000 
05162405220504552001 
2S1 62405220504552001 
221 10000000000000000 
220S2425221655200125 
14565522052425221655 
24220103310000000000 
40000002000001000000 
OOOOOOOOOOOOOOOOOOOO 
OOOOOOOOOOOOOOOOOOOO 
44000004000000000000 
13012211340000000000 
60010000030000000000 



6001000002600100000S 



| 12-23.3 



97404700C 



Record 6 



Record 7 



77000016000000000000 
13012211000000000000 
3336S03535S042355547 
33335733425734425755 
23031720055536573755 
03171520012323553657 
42343543365555555555 
55555555555555555555 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
34000001000000000000 
KART 13012211000000000007 
36000002000000000000 
13012211340000000000 
00000000000001000000 
40000007000001000001 
10100000000000000000 
43601206277110000004 
01000000006100046000 
■ 04000000006100046000 
05162405225513012211 
56552205242522165520 
01251400000000000000 
40000002000001000000 
00000000000000000000 
00000000000000000000 
44000002000000000000 
15230754000000000000 
60010000020000000000 



77000016000000000000 
24052222310000000000 
33365035355042355547 
33335733425734425755 
23031720055536573755 
03171520012323553657 
42343543365555555555 
55555555555555555555 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
34000001000000000000 
TERRY 24052222310000000010 
36000002000000000000 
24052222313400000000 
00000000000001000000 
40000010000001000001 
10100000000000000000 
43601206277110000004 
01000000006100046000 
04000000006100046000 
05162405220504552405 
22223156552205242522 
16552417550301141405 
22000000000000000000 
20000001000002000000 
00000000000000000000 
00000000000000000000 
44000002000000000000 
15230754000000000000 
60010000020000000000 



97404700C 



12-23.4 | 



Record 10 



77000016000000000000 
04042414110200000000 
S54236303344503342S7 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 

70000000000000000016 
04042414110200000005 
00000000000000000001 
24220103310000000003 
00000000000000000002 
2401151531000000,0003 
00000000000000000003 
24221116010000000003 
00000000000000000004 
20012514000000000003 
00000000000000000005 
13012211000000000003 
00000000000000000006 
24052222310000000003 
00000000000000000007 



LABEL HEADER 

DDTLIB 

73/09/07 



INDEX HEADER 

DDTLIB 

library in rec 1 

TRACY 

code in rec 2 

TAMMY 

code in rec 3 

TRINA 

code in rec 4 

PAUL 

code in rec 5 

KARI 

code in rec 6 

TERRY 

code in rec 7 



| 12-23.5 



97404700C 



COMPASS 3.73130 



o 

4i 
O 

o 
O 



0000000000 

1 7110000007 + 
3 7110000012 + 

5 0100000000 + 

6 0400000000 + 

7 47474723012411230611 
12 47474705162405225524 
15 

43100 





IDENT 
ENTRY 


TRACY 


1 PS 




MESSAGE 




MESSAGE 




RJ 




EQ 


Tl 


DIS 


T2 


DIS 




END 



STORAGE USED 
MODEL 74 ASSEMBLY 



73/08/07. 12.54,51 PAGE2 



TRACY 
TRACY1 



T1..R 

T2..R 

=XPAUL1 

TRACY1 

, /***SATISFIED FROM ALTUB*** / 

. /* * * ENTER TRACY. CALL PAUL* * * / 



18 STATEMENTS 
0.083 SEONDS 



5 SYMBOLS 
10 REFERENCES 



0000000000 REMARK 

1 7110000004 + 

3 0400000000 + 

4 53535323012411230611 Ml 
7 



IDENT 

ENTRY 

PS 

MESSAGE 

EQ 

DIS 

END 



41300 STORAGE USED 

MODEL 74 ASSEMBLY 



REMARKS 
REMARK 

M1..P 

REMARK 

. /$$$SATISFIED FROM ALTLIB$$$/ 

11 STATEMENTS 
0.033 SECONDS 



3 SYMBOLS 

6 REFERENCES 



TRACAIJ. 73/09/07. RAR ILAN UNIVERSITY. 

12. 59. 40. TRACY. T100. CM50000 . 

12. 59. 40. ACCOUNT, VR) 

12. 59. 40. COM PASS. 

12. 59, 40. ASSEMBLY COMPLETE. 44000B SCM USED. 

12,59.40, 0.161 CPU SECONDS ASSEMBLY TIME! 

12. 59, 41 . DEFINE (ALTLIB) 

12. 59.41. LIBGEN(N=ALTLIB,P=ALTLIB) 

12. 59. 41. LIBRARY GENERATION COMPLETE. 

12, 59,41. CP 0.189 SEC. 

12. 59. 41, CM 0.001KWH 

12. 59,41. MS 0.020 KPR. 

12. 59,41. LP 0.126KLN. 



USER LIBRARY^ ALTLIB 



Figure 12-10. User Libraries (continued) 



COMPASS 3.73130 



73/09/07. 13.45.14 PAGE 2 



4^ 
O 








►£■■ 

-3 





7110000007 -i 


ST 


O 

o 


2 


0100000000 X 




03 


3 


7110000013 i 






5 


7160247021 






7 


0G162405225503100503 


Ml 




13 


22052425221655031005 


M2 




16 







IDENT 

ENTRY 

MESSAGE 

RJ 

MESSAGE 

ENDRUN 

DIS 

DIS 

END 

43100 STORAGE USED 

MODEL 74 ASSEMBLY 



CHECK 

ST 

M1..R 

=XTRACY1 

M2..R 

, /ENTER CHECK, CALL EXTERNAL REFERENCE/ 

, /RETURN CHECK, TERMINATE/ 

ST 



20 STATEMENTS 
0.064 SECONDS 



6 SYMBOLS 
10 REFERENCES 



CHECK 












LOAD MAP. 


<3> 




SYMBOLIC 


REFERENCE TABLE. 




BLOCK ASSIGNMENTS. 




MSG = 





EXTERNAL 


2/04 2/06 


BLOCK ADDRESS 


LENGTH 


FILE 


Ml 


7 


PROGRAM= 


2/03 2/07 L 








M2 


13 


PROGRAM= 


2/05 2/08 L 


CHECK 100 


16 


LGO 


ST 





PROGRAM = 


2/02 E 2/03 L 


TKAilX, 116 


10 


DDILIB 


SYS 





EXTERNAL 


2/07 


fTAMMYN 126 
XTRINAV 135 


7 


DDTLIB 


TRACY1 





EXTERNAL 


2/04 


7 


DDTLIB 












/ 


' PAUL 144 


15 


DDTLIB 












( 


KARI 161 


7 


DDTLIB 












V 


CPUSYS 170 


32 


SYSLIB 


LOAD MAP. 

BLOCK ASSIGNMENTS. 




© 


LIBRARY 


Those foa fir%e-J~ art 
evevi f~/,eagt\ never 


y: '!*#*<-«. a 'to 


h <. ( &&*•** JB cf 


BLOCK 


ADDRESS 


LENGTH 


FILE 


LOAD MAP 


(D 




CHECK 


100 




16 




LGO 


BLOCK ASSIGNMENTS 




TRACY 


116 




10 




DDTLIB 








PAUL 


126 




15 




DDTLIB 


BLOCK ADDRESS 


LENGTH 


FILE 


KARI 


143 




7 




DDTLIB 








CPU SYS 


152 




32 




SYSLIB 


CHECK 100 
TRACY 116 
PAUL 126 


16 
10 
15 


LGO 

DDTLIB 

DDTLIB 


LOAD MAP. 

BLOCK ASSIGNMENTS. 




© 


£US£-.) 


KARI 143 
CTERRjD 152 


7 
10 


DDTLIB 
DDTLIB 












CPUSYS 162 


32 


SYSLIB 


BLOCK 


A DDRESS 


LENGTH 


FILE 








CHECK 


100 




16 




LGO 








TRACY 


116 




15 




ALTLIB ^ 








■*> PAUL 


133 




15 




DDTLIB 








m KARI 


150 




7 




DDTLIB 








01 CPUSYS 


157 




32 




SYSLIB 









Figure 12-10. User Libraries (continued) 



13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
■13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 
13.45 
13,45 
13,45 
13,45 
13,45 
13,45 
13,45 






14,001,OM50000. 

14, ACCOUNT, YP) 
COMPASS. 

15. ASSEMBLY COMPLETE. 44000B SCM USED. 
15 0.120 CPU SECONDS ASSEMBLY TIME. 
1 5 . A TTA CH(DDTLIB . A LTLIB) 
15, LIBRARY(DDTLIB) 
15.LDSET(MAP=B) 
15.LGO. 

15, ENTER CHECK, CALL EXTERNAL REFERENCE 
15, ENTERED TRACY, CALL PAUL 

15. ENTERED PAUL, CALL KARI 
15. ENTER KARI, RETURN PAUL 
15. RETURN PAUL, RETURN TRACY 

15 . RETURN CHECK, TERMINATE 
15.* 

16.* 

16 . LIBRARY (DDTLIB) 
16.LDSET(MAP=B) 
16 . LDSET(LIB=ALTLIB, MAP=B) 
16LGO. 

16. ENTER CHECK, CALL EXTERNAL REFERENCE 

16°** * SATISFIED FROM ALTLIB* * * 

16.***ENTER TRACY, CALL PAUL*** 

16, ENTERED PAUL, CALL KARI 

16ENTERKARI, RETURN PAUL 

16. RETURN PAUL, RETURN TRACY 

16. RETURN CHECK, TERMINATE 

16.* 

16.* 



© 



)(D 



16.LIBRARY(DDTLIB) 
16.LDSET(MAP=B) 

1 6 . LDSET(USE = TAMMY/ TRINA ) 
16.LGO. 

17. ENTER CHECK, CALL EXTERNAL REFERENCE 
17. ENTERED TRACY, CALL PAUL 

17. ENTERED PAUL, CALL KARI 
17. ENTER KARI, RETURN PAUL 
17. RETURN PAUL, RETURN TRACY 

17. RETURN CHECK, TERMINATE 
17.* 



ffrcfid Lo ci d inc of. 7~ornimy/7~r/f> 
even 7*/>oi*<)A cAecJc Joes ntif 
reference. tAe ft-oyray* s 



i i ■ 

17. 

17. 

17. 

18. 

18. 

18. 

18. 

18. 

18. 

18 

18. 

18 

18. 

18. 

18 

18 

18 

1 



.LDSET(USE=PAUL1/KARI/TERY1) "\ /2\ fAere are en try- f>a',» t s 

.LDSET(MAP = B) ) kL) ^A/cA force tAe re*t/»es 

.LGO. ' <Uith tftSSZ. ehTry-ofi/ifrf 

.ENTER CHECK, CALL EXTERNAL REFERENCE tl /oaJ 

.ENTERED TRACY, CALL PAUL 

.ENTERED PAUL, CALL KARI 

.ENTER KARI, RETURN PAUL 

.RETURN PAUL, RETURN TRACY 

.RETURN CHECK, TERMINATE 

.* .Force r,o-/e>A*L "f r°«ft'»€ 7~ra.€.y 

.* / 

.LDSET(OMIT= TRACY)' \ (g\ 

[ENTER CHECK, CALL EXTERNAL REFERENCE 

.ARITH. ERROR 1 AT 400103. Mots tret^y hct UaAe-A and the ca // A> 

. CP 0.389 SFC. Trac/1 ^aK^s a* uyisa t/sf/e J externa./ 

.CM 0.002 KWH. A <r<*// to 7>«.t/l / n/TV «. ?*>>* mct-rra-je- ahcve. 

.MS 0.145KPR. Figure 12-10. User Libraries (continued) 
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o 

-J 

o 
o 

W 



PROGRAM CIIK(OUTPUT, TAPE1.TAPE2) 
DIMENSION IBUFF(128) 
10 FORMAT 13110) 
DO 100 N = 10, 120, 20 
DO 50 1 = 1, N 
50 1BUFF(D N 

WRITE (1) (IBUFF(M). M=1,N) 
WRITE (2,10) (IBUFF(MM), MM = 1,N) 
100 CONTINUE 
STOP 
END 




PIDL 



FTN pro Auce. A Binary P<*.cK ENTER 



n : *T 



KEPL 



t\3 
-1 



V70000 16000000000000 
03101300O0OO0000O000 
33405033305042355555 
33345744425733405747 
23031720055536573755 
06 r >4 1655555555375733 
42353335424141414155 
55555555555555555555 
55555555555555555555 
55555555555555555555 
55555555555555555555 
55555555 555555555555 
55555555555555555555 
55555555555555555555 
55 555555555555555555 
(1)000008000000000000 
1^0002000000000000 
05172224220 1 1 6000000 
2331231 1 1_7 00 0000000 
3400000 1000000000000 
03101 300000000006407 
36000010000000000000 
0310 1300000000000000 
0000000000000100 6137 
17252420252460000000 
0000000000000 1000000 
240 12005346000000000 
0000000000000 1002036 
24012006356000000000 
000000000 0000100407 4 
400000 1 000000 1000000 
00400002000000000000 
00000000000000000000 
00000000000000000022 
00000000406000000000 
00000000002000000000 
00000000000000000000 
00000000000000000034 

oopooooooooo oooooooo 

4300000200000000000 1 
0000000000000 1000006 
0000250000 000 0000000 
40000010000001002036 
00400002000000000000 
00000000000000000000 
00000000000000002000 
00000000406000000000 



cuK 



scopf 3.¥ 
FTN M.o 



fi£ft. 



rtsT 



FORTR/IHf 

svsro 



LbC£T 
Table. 



00000000000001004102 

O OPOOOOOOOOOO OOOOOOO 

4000000000010 100 v 61 37 

405060005008 1.0002202 

51100061320100000000 

71700000125170006203 

51500062036120000001 

62780062066130006203 

6 1 100062074400046000 

56530107555671066121 

06710061445150006203 

71000000010160000002 

37450273007100006207 

10244206605110006172 

21273120062053015642 

72460000013670627004 

42610517000617426706 

5*1700061734600046000 

0100000 000000700 613 6_ 

4000000 6100001006132 

10420040000000000000 

rr* T 17252425252000000000 
24012005340000002036 
24012005350000004074 
77777777770000000000 
0310135 5 55555500613 7 
400000 1 0000001008 155 

T£*T 41104050004040000000 
5150004 7037100000002 
20060717000620712670 
51100161762053036765 
5 I 700062004600046000 
01000000000010006136 
51500062037276000024 
72077776065075046000 
03300061415110006202 
04000000004000046000 
5110005136040000000 
400000 1400000 1006 r/b 
00020000 104000000000 
55343355555500000000 
51343611343352555565 
00000000000000002036 
77777777777777777776 
77777777777777777776 
00000000000000000000 
00000000000000004074 



T&r 



Figure 12-11. FORTRAN Deck with LDSET. 



to 

oo 



TEXT 



REPL 



TEXT 



00000000002000000000 
00000000000000000000 
00000000000000002072 
00000000000000000000 
4300000200000000000 1 
00000000000001002044 
00002500000000000000 
40000010000001004074 
00400002000000000000 
00000000000000000000 
00000000000000004116 
00000000406000000000 
00000000002000000000 
00000000000000000000 



TEXT 



LINK 



XF£R 



00000000000000006170 
77777777777777777776 
00000000000000000000 
00000000000000000000 
44000010000000000000 
05160457000000000000 
40010061672324172057 
00000000006001006166 
17252403115700000000 
60010061621725240211 
57000000006001006155 
21431624223157000000 
40010061370000000000 
4600000 1000000000000 
03101300000000000000 



CO 
-q 
4^ 

O 

-J 

o 
o 

> 



Figure 12-11. FORTRAN Deck with LDSET. (continued) 



COMPASS 3.73130 



73/09/07.13.45.16 PAGE 2 



o 
il- 
ea 
o 



62 

62 24 

106 36 

144 144 



3 10 

3 10 0400000310 i 



311 00000000 i 

000062 * 

000106 I 

312 00000000000000000144 h 



313 00000000000000000000 X 

314 :3000000 X 

000000000000 





IDENT 


TST 


* 


ENTRY 


ST 


* 
TAG 


DSS 


50 


A 


BSS 


20 


B 


BSS 


30 


C 


BSS 


100 


* 






* 






ST 


BSS 





* 


EQ 


ST 


* 
XFILL 


VPD 


24/TAG, 18/A, 18/B 


* 


VFD 


60 /C 


* 
XLINK 


VFD 


60/-XDUMMY 




VFD 


24/=XDUMMY, 36/0 



XFILL/XUNK Binary P^K 

Ta Ue,s 



6-e^erafes XFJIL TaUe 
Generates XLINK T*.t>le 



* 
* 



3 15 



END 







41300 STORAGE USED 




23 STATEMENTS 






MODEL 74 ASSEMBLY 





,052 SECONDS 




SYMBOLIC 


REFERENCE TABLE. 










A 


62 PROGRAM* 


2/06L 


2/16 






B 


106 PROGRAM* 


2/07L 


2/17 






C 


144 PROGRAM* 


2/08L 


2/18 






DUMMY 


EXTERNAL* 


2/21 


2/22 






ST 


310 PROGRAM* 


2/02E 


2/11L 


2/12 




TAG 


PROGRAM* 


2/05L 


2/15 






XFILL 


311 PROGRAM* 


2/15L 






to 
1 
to 

CD 


XLINK 


313 PROGRAM* 


2/21L 







8 SYMBOLS 
15 REFERENCES 



Figure 12-12. XFILL, XLINK Tables. 



to 






- FILE DUMP - TDUMPd-LGO.O) 


73/09/07. 13,32,16 PACK 1 


k f 


1 


R 


1 W 


0- 


(7^00 0016 0000 0000 0000 


242o 2400 0000 0000 0000 


4236 5033 4450 3342 5755 


3436 5736 3557 3441 5755 


F 


1 


R 


1 W 


4- 


2303 1720 0555 3557 3355 


0317 1520 0123 2355 3657 


4236 3436 3355 5555 5555 


5555 5555 5555 5555 5555 


F 


1 


R 


1 w 


10- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


QO00 0000 0000 0000 0000 


F 


1 


R 


1 w 


14- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


(34)30 0001 0000 0000 0000 


F 


1 


R 


1 w 


20- 


2423 2400 0000 0000 0315 


(3^00 0002 0000 0000 0000 


2324 0000 0000 0000 0000 


CF000 0000 0000 0100 0310 


F 


1 


R 


1 w 


24- 


(2^00 0006 0000 0100 0310 


4040 0000 0000 0000 0000 


0400 0003 1061 0004 6000 


QQ00 0000 0000 6200 0106 


F 


1 


R 


1 w 


30- 


0000 0000 0000 0000 0144 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


(4U0O 0003 0000 0000 0000 


F 


1 


R 


1 w 


34- 


0000 0003 1122 2200 1001 


0000 0003 1144 3000 1001 


0000 0003 1200 7400 1001 


flfsoo 0003 0000 0000 0000 


F 


1 


R 


1 w 


40- 


0425 1515 3100 0000 0000 


0000 0003 1300 7400 0001 


0000 0003 1444 3000 0001/ 


\_VI lUtf 



-- END OF RECORD -- 

- END OF INFORMATION -- 

- END OF DUMP -- 



•YFILL 



CO 

-J 
*>. 
o 

-a 

o 
o 

> 



Figure 12-12. XFILL, XLINK Tables, (continued) 



-1 

o 
o 



500 



OV E RL A Y (XXXXXX, 0, 0) 
PROGRAM XTST(INPUT, OUTPUT) 
PRINT 500 

eormat(*main*) 
call overlay'6ijxxxxxx, 
1.0.6iirecall) 
call overlay (6iixxxxxx, 

2, 0,61 IRE CALL) 
END 



© 



500 



OVERLAY(XXXXXX, 1,0) 

PROGRAM XTST1 

PRINT 500 

FORMA T(* OVERLAY 1* ) 

END 



■Forces & RA\ £"«-Je of 



[tj - FILE DUMP - TDUMP0 


XXXXXX, 


' 


73/( 


r-' i it 


1 w 


0- 


QjfrO 0016 0000 0000 0000 


3024 2324 0000 0000 0000 


5542 3650 3344 5033 4257 


i' 1 i it 


t w 


4- 


4230 5033 4450 3342 5755 


3434 5734 


3757 3342 5755 


1322 1716 1723 3557 3455 


1-' 1 R 


1 w 


10- 


423G 3440 3541 4141 3055 


5555 5555 


5555 5555 5555 


5555 5555 5555 5555 5555 


K 1 It 


1 w 


14- 


5555 5555 5555 5555 5555 


5555 5555" 5555 5555 5555 


5555 5555 5555 5555 5555 


F 1 It 


1 w 


20- 


0000 0000 0000 0000 0000 


0000 0000 


(0164 6300 0000 


0000 0000 0000 0000 0000 


F 1 It 


1 w 


24- 


0000 0000 4060 0000 0000 


0000 0000 002010200 0000 


0000 0000 0000 0000 0000 


K 1 It 


1 w 


30- 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


0000 0000 0000 0000 0000 


2) 








LWA "f Lahaest Ovef/ay f" 


F 1 It 


2 W 


0- 


(7])00 0016 0000 0000 0000 


3024 2324 


3400 0000 0000 


5542 3650 3344 5033 4257 


K t It 


2 W 


4- 


1322 1716 1723 3557 3455 


0624 1655 


5555 5537 5733 


4236 3440 3541 4141 3055 


I- 1 1 It 


2 W 


10- 


5555 5555 5555 5555 5555 


5555 5555 


5555 5555 5555 


5555 5555 5555 5555 5555 


E 1 It 


2 W 


14- 


5555 5555 5555 5555 5555 


5555 5555 


5555 5555 5555 


5555 5555 5555 5555 5555 


P 1 It 


2 W 


20- 


7777 7777 7777 7776 6167 


3024 2324 


3455 5501 6453 


5110 0164 5101 0000 4275 


1'' 1 It 


2 W 


24- 


0100 0067 7200 0301 6452 


5110 0164 


5204 0000 4526 


0000 0000 0000 0000 2137 


P I It 


2 W 


30- 


0000 0000 0000 0000 0000 


5540 3333 


5555 0000 0000 


5147 5517 2605 2214 0131 


-- END OF RECORD -- 








V 1 It 


3 W 


0- 


(3b0 0016 0000 0000 0000 


3024 2324 


3500 0000 0000 


5542 3650 3344 5033 4257 


I'' 1 It 


3 W 


4- 


1322 1716 1723 3557 3455 


0624 1655 


5555 5537 5733 


4236 3440 3541 4111 3055 


V 1 It 


3 W 


10- 


5555 5555 5555 5555 5555 


5555 5555 


5555 5555 5555 


5555 5555 5555 5555 5555 


V 1 R 


3 W 


14- 


5555 5555 5555 5555 5555 


5555 5555 


5555 5555 5555 


5555 5555 5555 5555 5555 


P 1 It 


3 W 


20- 


7777 7777 7777 7776 6167 


• 3024 2324 


3555 5501 6453 


5110 0164 5101 0000 4275 


V I It 


3 W 


24- 


0100 0067 7200 0301 6452 


5110 0164 


5204 0000 4526 


0000 0000 0000 0000 2137 


1-' 1 It 


3 W 


30- 


0000 0000 0000 0000 0000 


5540 3333 


5555 0000 0000 


5147 5517 2605 22 14 0131 



/If) OVERLA Y (XXXXXX. 2 , 0) 

PROGRAM XTHT2 

PRINT 500 

500 FORMAT** OVERLAY 2*) 
END 

Address *>f enTry- 

pt'lnT In ft, ff>'{S 

/a/yerf ovc.t /a y" ^"\. 
)7. 11. 14 10 PAGE 1 



3024 2324 0000 0000 
0624 1655 5555 5537 
5555 5555 5555J555 
(§30(j)0000 OOOfljHjlOO 
""""" 0000 

0000 




0000 
5733 
5555 



0123 
0135 
0000 0000 



END OF RECORD -- 

END OF INFORMATION -- 

END OF DUMP -- 



00 0000 0000 
0000 0000 0000 
0000 0000 0000 

i-t.f>/e 1~/*>/t c. f /ck d 1 no 3 place 
RA+loo I.WA o-f /arrest- ovt>rl*f 

3434 5734 3757 3342 5755 
5555 5555 5555 5555 5555 
5555 5555 5555 5555 5555 
(§9>00 0100 0164 5001 6453 
5110 0164 5746 0004 6000 
0000 0000 0000 0001 6467 
5534 4752 5555 5555 5555 



3434 5734 3757 
5555 5555 5555 
5555 5555 5555 
(5^)00 0200 0164 
5110 0164 5746 
0000 0000 0000 
5585 4752 5555 



3343 57 55 
5555 5555 
5555 5555 
5001 6453 
0004 6000 
0001 6462 
5555 5555 



Figure 12-13. Overlay Generation With ACPM Table 



200 
200 
200 

201 
202 

203 
204 



7110000206 
1 
0100000242 
7110000211 
1 

0100000242 
7160247021 



'160200003 



7160200003 



1 20650 

205 0100000217 

206 55031005031355010223 

207 17142524055520071555 

210 00000000000000000000 

211 55474747474747474747 

212 47474747474747474747 

213 47000000000000000000 

214 / n*J* t c*~Js 

(jjoouo45dooooooooooo 

03100503130000000000 
55423450333750334257 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
03152055355733000000 ' 
ABS 51O000O0O00QJ75p)0O002 
oh£ 17160500000000000gcr 
Two 24271700000000000^0 
71100002067160200003 
0100000242 6100046000 
71100002117160200003 
0100000242 6100046000 
71602470212065046000 
0100000217 6100046000 
5503100503135'5010223 
17142524055520071555 
00000000000000000000 
55474747474747474747 
47474747474747474747 
47000000000000000000 
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IDENT 
ABS 
ENTRY 
ENTRY 
ORG 
CHECK BSS 
ONE MESSAGE 

SX6 200000B+3 
RJ =XMSG- 
TWO MESSAGE 

SX6 200000B+3 
RJ =XMSG = 

ENDRUN 
SX6 4RENDP/4 
LX6 40D 
RJ =XSYS= 
MESS DIS 



CHECK, CHECK 

ONE 

TWO 

200B 



MESS, 3, R 



MESS1, 3,R 



MESS1 



DIS 



XTEXT 



, /CHECK ABSOLUTE PGM / 



/***#************=!=*** / 



COMCSYS 



7/, 



•/e*/i 



0/ 



*To'hle 
CMP 2.0 



first WcrJ Of Object" CoAe 



Figure 12-14. Absolute Deck 
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54110201230331000216 
01300000006100046000 
0400000222 6100046000 
00000000006100046000 
51100000010311000220 
54610040000021646000 

51600002165110000001 
10611010000021546000 
20652010000021746000 
51100000010311000226 
00000000006100046000 
51100000010311000227 
7 id02203 140400000225 
20150366610100000217 
00000000006100046000 
71602203142065236662 
53160201730331000233 
03010002335110000001 
03110002357110000001 
04000002326100046000 
12661010000021746000 
00000000006100046000 
20630121617160152307 
20652040000024146000 



Figure 12-14. Absolute Deck (Continued) 
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IDENT 


PRG1 








LIST 


L,R, G, D 








ENTRY 


FIRST, INTMULT 





5110000011 + 


FIRST 


SA1 


INTEGER 




5120000012 + 




SA2 


INTEGER+1 


1 


0100000005 + 




RJ 


INTMULT 


2 


5170000000 C 




SA7 


PA RAM 




0100000000 X 




RJ 


=XSECOND 


3 


7160247021 

20650 


LX6 40D 


ENDRUN 




4 


0100000000 X 


RJ =XSYS= 






5 


00000000000000000000 


INTMULT 


DATA 


IN' 


6 


27101 




PX1 


BO, XI 




24101 




NX1 


BO, XI 




27202 




PX2 


BO.X2 




24202 




NX2 


BO,X2 


7 


40712 




FX7 


XI* X2 




26717 




UX7 


B1.X7 




22717 




LX7 


B1.X7 


10 


0400000005 + 


^ 


EQ 


INTMULT 


11 
12 


00000000000000000024 
00000000000000000003 


INTEGER 


DATA 

USE 


20,3 
/BLK/ 







PA RAM 


BSSZ 

USE 


5 

// 



1 




BLANK 


BSS 

END 


10 
FIRST 



INTEGER MULTIPLY 



DEFAULT SYMBOLS DEFINED BY COMPASS. 



X 
X 

I 

13 



SECOND 
SYS= 









IDENT 


PRG2 








LIST 


L,R,G, D 








ENTRY 


SECOND 





00000000000000000000 


SECOND 


DATA 





1 


5110000000 C 




SA1 


VALUES 




10211 




BX2 


XI 


2 


0100000000 X 




RJ 


=XINTMULT 


3 


5170000001 C 




SA7 


VALUE S+l 




0400000000 + 




EO 

USE 


SECOND 

/BLK/ 







VALUES 


BSS 


5 






DEFAULT SYMBOLS DEFINED BY COMPASS 





X 


INTMULT 







END 



Figure 12-15. Relocatable Program 
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PRG1 



'Ri 



77000016000000000000 
20220734000000000000 
55423450333750334257 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
03152055355733000000 C/vj/> Z. <? 

(§3000003000000000000 

■£U£,SU I otuuuuuuuuumo 

02141300000000000005 
55555555555555000012 
<H)D00004000000000000 
06112223240000000000 
00000000000001000000 
11162415251424000000 
0000000000000 1000005 
@0000 1400000 1000000 
5200000000 1000000000 
51100000115120000012 
01000000056100046000 
5 1700000000 100000000 
71602470212065046000 
01000000006100046000 
00000000000000000000 
22101241012720224202 
@fr 12267 172271746000 
04000000056100046000 
00000000000000000024 
00000000000000000003 
40000002000003000000 
00000000000000000000 
00000000000000000000 
(43)00000200000000000 1 
00000000000003000000 
00000400000000000000 
@)00000 1000000000000 
00000000036001000002 
©000004000000000000 
23312354000000000000 
60010000040000000000 
23503171604000000000 
@0 10000020000000000 
^000001000000000000 
061 12223240000000000 



77000016000000000000 
20220735000000000000 
55423450333750334257 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 

f 52055355733000000 
00002000000000000 

02141300000000000005 
36000002000000000000 
23503171604000000000 
0000000000000 1000000 
40000005000001000000 
00001000000000000000 
00000000000000000000 
51100000001021146000 
01000000000100046000 
51700000010400000000 
42000002000000000000 
00000000036001000001 
60010000030000000000 
44000002000000000000 
11162415251424000000 
60010000020000000000 



CAl P 2, 



Figure 12-15. Relocatable Program (continued) 
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TELEX INTERACTIVE SUBSYSTEM 



13 



13.0 INTRODUCTION 

TELEX is a subsystem that Provides su n oort for interactive processing from remote term- 
inals such as TTYs (Teletypewriter Terminals) and 713s. The subsystem consists of a CP 
program and several PP programs as follows: 

TELEX - TTY Executive Initialization Routine. This routine is loaded at 

40000B relative to control point 1 when the operator types TELEX. 
It initializes tables and pointers and loads TELEX1. 

TELEX1 - TTY Executive Processor. This is the main routine that processes 
I/O for the TTY's. It cracks and processes commands, and makes 
requests to dump source input to disk and refill output buffers from 
disk. It communicates with TRA.NEX (at another control point) 
to support transaction terminals. 

TELEX2 - TTY Executive Termination Routine. This routine is executed 
after an abnormal condition is detected or when the operator 

terminates TELEX with l.STOP. 

1TA - TELEX Auxiliary Function Processor. This routine processes 

functions for TELEX which require PP action. 

LTD - Terminal Communications Driver low-speed interactive (600 baud I 

or less). It performs communications between TELEX. and terminals 
(accessed via the 6671 and 6676 multiplexers). It also communicates 
between TELEX and the KRONOS Stimulator (Checkout/ Test) 

1TO - Terminal Input/ Output. Called by TELEX to perform terminal I/O 

requiring disk accesses. 

PFM - Permanent File Manager. Called by TELEX to process PF requests. 

The relationship between the various system routines and subsystem routines is shown in 
Figure 13-1. 



13.1 TTY OPERATION 

The flow of data to or from a TTY and a mass storage device is shown in Figure 13-2, The TTY 
user enters source statements at a TTY using BASIC or TSRUN, etc. These statements are 
built character by character and stored in POTS (a POT is an eight word buffer) by 1TD. 

Whenever 1TD has filled VTPL pots (level-6 CIPL -2), he issues a dump pot request. TELEX 
will initiate the routine DMP (local to TELEX) which will call 1TO. In the interim 1TD may 
have filled another pot. 1TO will dump the VTPL pots onto one sector on MS. Thus, currently, 
during this phase 20 or 30 words will be written per sector. This is a very inefficient way 
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to use MS. This will continue until the user enters a command that forces a sort such as 
RUN or LIST. If the unsorted file is too large, then the message FILE TO LONG TO SORT is 
issued. In this case, the user must issue the SORT command. 

If, however, the file is not too long, then the terminal is placed in sort mode. An MTOT job 
called MSORT is generated and all users in sort mode will be sorted at once. These users are 
queued up until a specified time interval has expired, then the MSORT job is run. All the files 
are given to MSORT in file size order, largest first. 

MSORT is an in core SHELL sort. It is started at a CP with the FL necessary to sort the 
largest file. It will sort the file and rewrite the file in packed format (i.e. , 100 words per 
sector). When MSORT has finished a sort, it will release FL down to the necessary size for 
the next file and will then sort it. This continues until all the files have been sorted. When 
MSORT ends, it will be rolled back to TELEX via 1RO. 1RO will set all the terminals whose 
files were sorted to active mode and TELEX will then process the command that indirectly 
cause the sort. 

This command causes the system to compile a user's job and executes the generated code. 

13.1.1 TTY Job Initiation 

Refer to Figure 13-3 for this discussion. Assuming that a user's Primary File has been 
sorted and RUN is typed on the TTY, the following sequence of events occurs. 

1. TELEX builds a control card in a POT and calls 1TA. . {actual control card is: 

$LDC, . . . .parameters ) This will be detected later by 1AJ to load the 

compiler . 

2. 1TA builds a ROLLIN queue entry in the system FNT/FST area. The FNT entry 
will point to the user's rollout file (shown in Figure 13-30). 

3. Some time later, the scheduler, 1SJ, will determine that this is the "best job" 
to initiate, so calls 1RI to rollin the job. 

4. 1RI reads the rollout file to build system FNT entries as specified, builds 

an FNT entry for the Primary File (input to compiler) and initializes a control 
point . 

5. 1RI then calls 1AJ to advance the job which detects the $LDC control cards and 
loads the compiler with sufficient field length to compile the source statements. 
After compiling, the program is executed As the job executes it interacts 

with the TTY by issuing output and receiving input. This interaction is discussed 
subsequently under "TTY Job Interaction - Output/Input". 
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13.1.2 TTY Job Interaction - Output 
Refer to Figure 13-4 for this discussion. 

1. CIO is called when the Interactive program issues a write request to the Output 
file. CIO senses that this is a time-sharing Job (TXOT) and issues monitor function 
ROCM to rollout the control point. 

2. Some time later, 1RO initiates the rollout and copies the entire field length (including 
output data) to the rollout file. In addition, all FNT entries associated with this 
control point are removed from the system FNT area and stored on the rollout file. 
Prior to calling 1TO, 1RO reads the first sector of output into IRO's PP memory where 
it can be picked up by 1TO without additional disk input/output. 

3. 1TO is loaded into the same PP as 1RO. The monitor function TGPM assigns 1TO 
POTs which store the output data. 1TO then informs TELEX that output is available 
for the TTY by issuing monitor function TSEM. 

4. 1TD is called by TELEX to transmit the output data in the POTs to TTY. 1TD continues 
to ask TELEX for additional output and TELEX in turn calls 1TO until all output has 
been transferred. 

5. After all output is transferred, TELEX calls 1TA to reinitiate the time-sharing job. 
1TA builds the Rollin file entry in the system FNT area as discussed previously. 

6. Scheduler 1SJ selects this queue entry as the "best job" as previously discussed and 
calls 1RI. 

7. 1RI rolls the job into a free control point as discussed previously and the time- 
sharing job continues to execute. 

13.1.3 TTY Job Interaction - Input 

Refer to Figure 13-5 for this discussion. Assuming that the time-sharing job is to receive data 
(input) from TTY, the system performs the following functions. 

1. The job issues a read request on the Input file which calls CIO. CIO issues monitor 
function ROCM to rollout the job. 

2. Some time later, 1RO is loaded to perform the rollout operation. 1RO then calls 1TO. 

3. ITO issues monitor function TSEM to inform TELEX of the requested input. 

4. TELEX calls 1TD to issue the input prompt character " ?". 

5. 1TD stores characters in POTs as they are received from the TTY. 

6. When the TTY carriage return is sensed, TELEX calls 1TA to reinitiate the time-sharing 
Job. 1TA builds a rollin queue entry. 

7. 1SJ selects the queue entry as the "best job" and calls 1RI. 

8. 1RI rolls the job into an available control point and transfer the Input date from the 
POTs to the job's circular buffer. The Job is then initialized (given the CPU) and 
continues to execute. 
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13.1.4 TELEX Interactive Job Name s 

Whenever a job is initiated at a CP, 1TA will generate a job name based on the terminal number 
and UI of the user. The common deck COMPGIN generate job name is used for this task. 
Whenever a job is rolled back to TELEX by 1R0, the job name must be decoded back to the 
terminal number. 1R0 uses the common deck COMPGTN generate terminal number for this 
task. In this way, 1RO knows which terminal table in which to indicate the rollout back to 
TELEX. The terminal number is coded into the fourth through seventh characters of the job name , 
The UI is coded into the first thru fourth character. The fourth character then does double 
duty as part UI and part terminal number. 
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I 13.1.5 Interactive COMPASS (Program Example) 



GET,6ATFIL£ 
READY. 

LIST,F=6ATFILE 

7 1/04/08. "14. 03.36. 
PROGRAM BATFILE 





IDENT 


INTER 




ENTRY 


START 


OUTPUT 


FILEC 


OUTBUF. 65, (FET=6) 


OUTBUF 


BSSZ 


65 


OUT 


DIS 


10, THIS PROG. CHECKS ON INTERACTION 


INPUT 


FILEC 


INBUF, 65, (FET=6) 


INBUF 


BSSZ 


65 


IN 


BSSZ 


20 


SETUP 


VFD 


42/OLOUTPUT, 1 8/OUTPUT 




VFD 


42/OLINPUT, 1 8/INPUT 


START 


SAI 


SETUP 




SA2 


Al+I 




BX6 


XI 




BX7 


X2 




SA6 


2 




SA7 


3 




SX6 







SA6 


4 




WRITEH 


OUTPUT, OUT, 10 




READH 


INPUT, IN, 10 




WRITEH 


OUTPUT, IN, 10 




WRITER 


OUTPUT, R 




END RUN 






END 


START 


READY. 






REWIND, 


BATFILE 




READY. 







BATCH, 5 0000 

/COMPASS (l=BATFILE,B=8ATBIN,L=0, 0=0) 

ASSEMBLY COMPLETE. 
/BATBIN. 

THIS PROG. CHECKS ON INTERACTION 

? CALGARY IS IN ALBERTA 

CALGARY IS IN ALBERTA 

BATBIN. 

/FORTRAN 

READY. 
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13. 2 TELEX INITIALIZATION 

a_>ci<s iwau T; >*. J— * uuA tii 4. ;ia*i^co bauiCa glum wwmt>\:« oi ujcu iwauo anu o lo. a u& j. j-j *— u— >^i. x a vj.iv? iiiaui 

routine. PP programs called during intialization include: 

CIO - Combined Input/Output 

CPM - Control Point Manager 

LDR - Load Overlay 

LFM - Local File Manager 

IMA - Issue Dayfile Message 

1TA - Auxiliary Function Processor 

1TD - Terminal Multiplexer Driver 

When the operator types TELEX., DSD calls IDS which calls 1TD into a PP. 1TD sets 
the following control cards into the control card buffer: 

TELEX. 
TELEX2. 
EXIT. 
TELEX2. 

1TD then calls 1AJ to process the next (first) control card by using the "DIS flag" in the 
request. 1AJ picks up the first control card, TELEX, has it loaded, and starts the job. 
After sensing that the driver is ready (at IN13), TELEX allocates tables and establishes 
the pointers listed in Table 13-1. 
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Word 

RA+3 
RA+4 
RA+5 
RA+6 

RA+10 
RA+11 
RA+12 
RA+13 
RA+14 



Name 

VTTP 
VPLP 
VCTP 

VBMP 

VRAP 

VFNL 

VPTP 

UTRN 

DBUG 



59 



Table 13-1. Pointer Addresses 

Description 
47 35 







23 



FWA 

TERMINAL TABLE 



POT LINK TABLE 



FWA 



11 



LWA+1 
TERMINAL TABLE 



LWA+1 

POT LINK TABLE 







LWA+1 



TWK 

BUFFER MEMORY 



" 


WARN MESSAGE 


HEADER MESSAGE 





FWA 

TELEX REENTRY TABLE 


LWA+1 


Default Family Name 





FWA 
TRANSACTION 


LWA+1 
WORD TABLE 




.... 


RECEIVE FROM 
TRANE X 


SENT TO 
BUFFER 





A 




B 


1 
C 



A = driver (1TD) minimum cycle time 
3 = Moved to C each driver scan 
C = |0 driver scan continues 

(not zero driver scan stops 

So, DBUG can be used to debug the driver. 



Word 

RA+17 
RA+20 
RA+21 
RA+23 
RA+26 
RA+27 
RA+31 
RA+3 2 

RA+36 
RA+3 7 
RA+44 
RA+50 

RA+60 



Pointer 

VPPL 

VTNL 

VANL 

VMNL 

VCPL 

VRLL 

VABL 

VPLL 

VPAL 
VPUL 
VDRL 
VTRP 
VTGP 
MUXP 



Table 13-1.1 Pointers 

Description 

NUMBER OF TIMES HAD TO WAIT FOR A PP. 

TOTAL NUMBER OF USERS SINCE INITIALIZATION. 

NUMBER OF USERS ACTIVE CURRENTLY. 

MAXIMUM NUMBER OF ACTIVE USERS. 

CONTAINS NEW AVAILABLE POT COUNT DURING THE FL CHANGE. 

NON-ZERO INDICATES THIS IS A RECOVERY LOAD. 

ABNORMAL OCCURENCE COUNT. 

BYTES 1,2 = MINIMUM NUMBER OF SPARE (POTS/4) , 

BYTES 3,4 = MAXIMUM NUMBER OF SPARE (POTS/4). 

COUNT OF POTS AVAILABLE. 

COUNT OF POTS IN USE. 

DRIVER PARAMETER AREA. (4 WORDS) 

FWA OF MONITOR QUEUE FOR *TSEM*. 

FWA OF MONITOR QUEUE FOR *TGPM*. 

TELEX MULTIPLEXER TABLE 
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Constant 


Value 


VTTL 


10 


VDSL 


100 


VSPL 


20 


VMPL 


40 


VOPL 


3 


VIPL 


2 


VTRL 


10 


VTGL 


3 


VCPT 


1 


VJIR 


2 


VRIR 


4 


VIPR 


10 


VOPR 


20 


VCPC 


10 


VDPO 


2000 


VASO 


2001 


VMSG 


2002 


VSDT 


2003 


VCDT 


2004 


NULS 





BASS 


1 


FORS 


2 


EXES 


4 


BATS 


5 


ACCS 


6 


MSYS 


7 


UTIS 


10 


MTIS 


777 


VPST 


4 


SCPT 


1 


SOPT 


2 


VSBL 


110/VCPC 


VRBL 


110/VCPC 


MPLT 


120B 


WCQT 


1 


WCOT 


100 


LIAA 


A 


CBASE 





LISDL 


2 


COMDL 


6 


EXEDL 


5 


CATDL 


5 


SORDL 


2 


BATDL 


4 


RESDE 


4 


SWPDL 





NULDI 


10 


BASDI 


4 


FORDI 


4 
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Table 13-1.2 Constants {Lev 4) 

Description 

LENGTH OF EACH TERMINAL TABLE ENTRY. 
LENGTH OF DRIVER CIRCULAR STACK 
MINIMUM NUMBER OF SPARE POTS PER 64 USERS. 
MAXIMUM NUMBER OF SPARE POTS PER 64 USERS. 
NUMBER OF POTS ISSUED ON REQUEST. 
NUMBER OF INPUT POTS ALLOWED BEFORE DUMPING. 
NUMBER OF WORDS IN MONITOR QUEUE *TSEM*. 
NUMBER OF WORDS IN MONITOR QUEUE - *TGPM*. 
*TELEX* CP NUMBER. 
JOB IN SYSTEM 
JOB TO BE ROLLED IN AGAIN 
INPUT REQUESTED 
OUTPUT DATA AVAILABLE 
NUMBER OF WORDS PER POT. 
DROP POTS. 
ASSIGN OUTPUT. 
TERMINAL MESSAGE 
SET DISABLE TERMINAL CONTROL 
CLEAR DISABLE TERMINAL CONTROL 
NULL SYSTEM. 
■ BASIC SYSTEM. 
FORTRAN SYSTEM. 
EXECUTE SYSTEM. 
BATCH SYSTEM. 
ACCESS SYSTEM. 
MAXIMUM NUMBER OF SYSTEMS. 
DEFAULT USER TIME LIMIT/10. 
MAXIMUM TIME LIMIT/10 ALLOWED A USER. 
NUMBER OF PSEUDO TERMINAL TABLE ENTRIES 
SCHEDULING PSEUDO TERMINAL NUMBER 
SORT PSEUDO TERMINAL NUMBER 
TRANSACTION SEND BUFFER LENGTH IN POTS 
TRANSACTION RECEIVE BUFFER LENGTH IN POTS 
NUMBER OF PLT WORDS PER 64 USERS ON IN PRIVILEDGED 
COMMANDS 

WAIT COMPLETION QUEUE DELAY TIME fMSEC.) 
LOG IN ATTEMPTS ALLOWED 

DEFAULT BASE FOR COMMAND PARAMETER (OCTAL) 
LIST DELAY TIME 
COMPILE DELAY TIME 
EXECUTE DELAY TIME 
CATLIST DELAY 
SORT DELAY TIME 
BATCH TIME DELAY 
RESEQUENCE DELAY 
SWAP IN DELAY 

NULL INPUT RESPONSE DELAY TIME 
BASIC INPUT RESPONSE DELAY TIME 
FORTRAN INPUT RESPONSE DELAY TIME 
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Table 13-1.2 Constants (Lev 4) (Continued) 



Constant 


Value 


EDIDI 


2 


EXEDI 


4 




■-J 


ACCDI 


10 


SYSDI 


3 


SORFL 


4100B 


MSORFL 


4 


SALTO 


3 



Description 

EDIT INPUT RESPONSE DELAY TIME 
EXECUTE INPUT RESPONSE DELAY TIME 

ACCESS INPUT RESPONSE DELAY TIME 

SYSTEM PROCESSED COMMANDS 

SORT BASE FIELD LENGTH 

MULTI - TERMINAL SORT BASE FIELD LENGTH 

SALVARE FILE TIME CHECK (MINUTES) 
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After initializing the tables, TELEX modifies addresses in TELEX 1 code which use the- 
increment instruction OPDEFs. Next, each terminal table entry is set to "COMPLETE." 
status by setting YROT = 3 in each entry. Next, VWMP, the warn message address is 
set to the normal header: KRONOS TIME SHARING SYSTEM - YER. 2.1. Nex', TELEX 
calls 1TA to search for time-sharing jobs in the system The jobs searched for are TXOT 
and MTOT type. The count of such jobs is returned in a pseudo terminal table for TELEX 
If the count is non-zero, TELEX aborts with the message: TELEX INITIALIZATION ABORT. 
Next, each driver queue is initialized by setting FIRST, IN, OUT, and LIMIT. Indeed, 
the driver queues are used like circular buffers. Finally, after starting the drivers and 
initializing the recovery file (SALVARE), TELEX is complete and control is given to 
TELEX1 by an EQ jump to TEL. 

13.3 TELEX1 - MAIN PROGRAM 

TELEX1 is the main program that controls and coordinates the time-sharing subsystem. 
This program is driven by the following queues: 

Request Entering TELEX: 

Driver Request Queue - Requests from 1TD 

Monitor Request Queue - Requests from other PPs 

Monitor Pot Request Queue - Requests from other PPs for pots 

Internal Control: 

Wait Completion Queue - Wait for completion of a process 
Time Delay Queue - Wait for time to elapse 
Job Queue - Wait to do all job scheduling at one time 
Sort Queue - Wait to do all sort scheduling at one time 

Requests sent by TELEX: 

1TA Queue - Send all 1TA requests at one time 
1TO Queue - Send all 1TO requests at one time 
PFM Queue - Send all Permanent File Requests at one time 

These queues are scanned by the TELEX1 control loop which is defined in the TELEX 
flow chart of Figure 13-6. 
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Figure 13-6. TELEX1 Control Loop 
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*1 The fonnat of the SALVARE file is: 

It is two - one word entries per port. 

The rollout file contains the Terminal Table entries. For any activity, it is updated. Every 
3 minutes the SALVARE file is checked and if the time is over 10 minutes old, the entry is 
removed, the rollout file dropped, and the terminal logged off if still connected in the 
Terminal in READ mode. If the terminal is dropped because of a system failure and a new 
user logs onto the same port and he also is dropped, then the file contains up to two users 
recoverable per port. Any others are lost. The users must recover within 10 minutes of 
system recover;,' or their SALVARE file entry will be eliminated. If the system does no: 
recover until 10 minutes or more have lapsed, the users must log in within 3 minutes to 
recover. See example of the SALVARE file at the end of this chapter in section 13.9. 
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The relationship between processing modules of TELEX1 is shown in Figure 13-7. 
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Command 
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Figure 13-7. TELEXl Processing Modules 



In general, all tables in TELEX are dynamic in length at initialization time. The lengths 
of the various tables and queues are determined by the maximum number of terminals 
to be serviced. Thus, it is necessary for all routines at initialization time to determine 
the values of table pointers, etc. Once TELEX is initialized, the lengths of tables do 
not change. Thus, pointers such as FIRST and LIMIT could be read and saved by programs 
that are time critical, These pointers could also be saved as abolute addresses because 
TELEX will never pause for a storage move. Thus no SYSEDITs should be run while 
TELEX is running. TELEXl memory layout is shown in Figure 13-8. 
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Statistics 


VTRP 


TSEM and TGPM Queues 


RA+101B 


Multiplexer Table 


TRQT ' 


Queue Table 


PCOM 


Sub- system Tables 




W//??r& / ////A 


TCOM^ 


Command Table 




A^m^AAA 


TRRT-""^ 


Reentry Control Table 




///// ( I ' i ' '///// 
'///// suorou tines '///// 


PBUF^*" 
SBUF 


Command Parameter 
Buffer 




Y//// y / ' ' '/////a 

//// . Subroutines / / / / / 
///// / / // /////A 


(VDRL) 


Driver Request Queue 


(7TTP)— * 


Character Translation ! 
Tables 


(VRAP) 


Terminal Table ! 


(VPTP) 


Re-entry Table 


(VPLP) 


Transaction Word Table 


(VBMP) 


Pot Link Table 




Pots 
(8 -word Buffers) 


RAxFL 





ABT = load address for 
TELEX2 (the termination 
routine) . 



Ml 



Coded 
Routines 



Figure 13-8. TELEX1 Memory Map 
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Driver Request Queue(s) 



Driver (1TD) Requests are passed to TELEX1 via the Driver Request Queue which are 
Circular stacks as shown in Figure 13-9. 

18 24 18 



>5 words 



FIRST 



LIMIT 



Driver Name 





Pointer to next 

stack 




FIRST 




IN 




OUT 




LIMIT 


Driver Request Queue Entries 
(one word each) 



V 100B 
words 



Figure 13-9. Driver Request Queue Stack 

Driver Request Queue Entries are placed in a circular stack by 1TD. IN pointer is updated 
by 1TD when an entry is placed into the queue . TELEX1 updates the OUT pointer as the 
driver requests are completed. The driver name is stored in word 1 with a pointer to 
the next stack. A zero pointer indicates the last stack. Each stack is 105B words long 
(100B words for entries +5 header words) . A maximum of eight stacks exist; one for each 
driver (1TD). The entries are one word each as shown in Figure 13-10. 



59 



48 47 



36 35 



24 23 



12 11 



2000+RQ 





P2 


PI 


TN 



RQ = Request Number 
P2 = Parameter 2 
PI = Parameter 1 
TN = Terminal Number 



Figure 13-10. Driver Request Queue Entry 

The request number is always biased by 2000B so that a jump table index can be stored 
in a B register with use of the unpack instruction. For example, if the above word is in 
X2, consider the instruction: 

UX1.B7 X2 



| 13-14 



97404700B 



Tne result is that B7 contains the request number and XI contains the parameters and ierr 
inal number (i.e., the lower 48 bits). A list of request numbers (request codes) is main- 
tained in common deck COMSTDR and are listed in Table 13-2. 

TABLE 13-2. DRIVER REQUEST NUMBERS (Issued to TELEX) 



Request 
Code 



Symbol 



Description 




1 
2 
3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 
16 
17 
20 
21 
22 
23 



AOD 
CSC 

DIN 
DLO 

DRP 
DRT 
HUP 
IAM 
ITM 
LOF 
LPT 
MAL 

MIN 
RES 
RIN 
SKY 
SPT 
SSC 
TTI 



n po£ 



Increment retry count 

Circuit scan complete 

Command line input, Pl = first pot,P2=wc 

User dialed in 

Data lost, P2=type 

Drop pot, 

Drop pot chain, Pl=t'irst pot 

User hung up phone 

Issue accounting message, P2=type 

Issue terminal message, P2=message number 

T «~ ~Cf ,, c-^~ 
LOg Oil U3<=i 

Request additional pot, Pl=current pot 

Set transaction terminal malfunction 

Pl = status (1 malfunction, 0=O. K.) 

Terminate monitor mode (monitor teletypewriter 

Request more output, Pl = current pot 

Release source line, Pl=first pot 

Interrupt from terminal, P2=interrupt level 

Set transaction output pot, Pl=pot 

Set transaction sequence code, Pl=code 

Transaction terminal input 



13. 3.2 Monitor Request Queue(s) (for PPs other than 1TD) 

PP requests for TELEX processing are handled via the PP monitor function TSEM. The 
message buffer is set up by the requesting PP according to the format shown in Figure 
13-U. 



59 48 


47 


36 


35 




24 23 


12 


11 







2000B - 
FN 


PI 


P2 


P3 


P4 



where, 

PI = P4 are parameters depending on the function 

FN - function code . These function codes are defined in packed format 

in common decs <_UiVion.c..u, nicy Eic usieu ui laaic u-o 



Figure 13-11. TSEM Monitor Request Format 
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TABLE 13-3.. COMSREM FUNCTION CODES 



Name 


Value 


Description 


VDPO 


2000 


Drop pots 


VASO 


2001 


Assign terminal output 


VMSG 


2002 


Assign terminal message 


VSDT 


2003 


Set "disable terminal control" flag 


VCDT 


2004 


Clear "disable terminal control' flag 



PP monitor picks up the above request and stores it in a free slot in TELEX'S monitor 
queue for TSEM functions. This queue is located at VTRP in TELEX and is 10B words long. 
If no slot is free in this queue, monitor (MTR) keeps trying until TELEX honors an existing 
request and clears a slot. 

In general, TELEX drops any unused pots in the chain. If the last pot is not completely 
filled by the routine issuing output, the routine must put in a terminator byte (0001) 
in the output data. 

NOTE 

4 
When issuing a 2001, terminal status must have bit 2 set in VROT. 



The parameters for the various functions are shown in Figure 13-12. 
VDPO - drop pots; TELEX routine - DRT 



2000 


0000 


YYYY 


xxxx 


NNNN 



where, 



YYYY = last pot to be dropped 
XXXX = first pot to be dropped 
NNNN = terminal number 



VASO - assign output; TELEX routine - ASO 



2001 


0000 


YYYY 


XXXX 


NNNN 



where, 

YYYY = last pot of output 

XXXX = first pot of output 

NNNN = terminal number 



Figure 13-12. TSEM Monitor Function Parameters 
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VMSG - assign message; TELEX routine - DSD 



auua 



uuuu 



XSXX 



NNNN 



Where, 

YYYY 
XXXX 

NNNN 



last pot of message 

first pot of message 

terminal number . If below maximum number of pseudo 

terminals, then this is a warning message sent to all 

terminals. 



VMSG is used by DSD to process the DIAL and WARN operator commands . 

13.3.2.1 VSDT and VCDT TSEM Requests 

When a TTY user initiates a CP program, the TTY reserves the right to terminate that program 
with the S or STOP entry. If the CP program wishes to disable/enable this function it can use 
the DI3TC macro described on p. 7-155 of the Reference Manual. Ihis macro generates an 
RA+1 call to the PP routine TLX. (Notice that if the QP > MXPS+1 , mis will be interpreted as 
a CPUMTR function). TLX will issue the appropriate TSEM request function 2003 or 2004, 
which will set the terminal Interrupt address in TIAW as follows. The disable function will 
ignore this field , and set the disable bit in the terminal table VSTT . The enable function will 
set this field to the address relative to RA specified in the call and clear the disable bit in the 
terminal table VSTT. The address is: 

1. If INT not specified, then the address is where control is transferred if an S or STOP is 
sensed on the TTY. 

2. If INT is specified, then the address points to a 20B word block where the CP programs 
exchange package is stored. Control is then transferred to address +20B. The CP routine 
then can issue an XJR to continue from where it was interrupted. In both cases , "if S or 
STOP is sensed, when control has been transferred, the interrupt address is cleared, so 

a new DISTC request must be issued. 

Figure 13-12. TSEM Monitor Function Parameters (continued) 

Pots for output are obtained by issuing the monitor function TGPM. The requests are handled 
by TELEX in a 3 word queue similar to TSEM requests , 



Call: 


12 




48 




OR= 


TGPM 





Return: 


12 


12 


36 




OR= 





P 






P = pot pointer, if no pots available. 
If P=0, PPU should reissue the request. 
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The TELEX TGPM queue size is an assembly constant. Currently at Level-6 it is 3 words long. 
Whenever a PP needs a POT chain it issues the TGPM MTR request. MTR will search the 
TELEX TGPM queue for a non zero entry. If MTR finds one, it will be the 1st POT of a POT 
chain. The chain size is an assembly constant and is currently (at level-6) fixed at 3 POTs. 
This POT chain is assigned to the calling PP and the queue entry is zeroed. If the queue is 
empty, MTR will issue an RCLM on TELEX. 

During TELEXs main loop it will check this TGPM queue and if it finds any empty entries, it 
will generate a POT chain and place the 1st POT number in the queue. 

The mjaor user of TGPM is 1RO, who requests POTs for flushing a TXOT type jobs OUTPUT 
file. Another user is DSD, who must get a POT chain for the WARN and DIAL messages. 



13.3.3 



Terminal Table 



The terminal table contains an eight word entry for each possible active user. Each entry 
contains the current status of each port on each multiplexer. These eight- word entries 
are structured in such a way so as to minimize interlocks between TELEX1 and the various 
PP routines which read and write them Each word is shown in Figure 13-13 together with the 
routines that read and write the word . 



Word 
VUIT - written by TELEX1 



read by 1TA 



59 



USER NUMBER 



42 



18 17 



US ER INDEX 

IB 



VFNT - written by TELEX1, 1RO 
read by 1RI, 1TA 



59 



Primary File Name 



42 



18 17 



12 11 







Mode 



Batch FL' 



12 



Modes - 

Write lockout - bit set 
Execute only - bit 2 set 



Figure 13-13. Terminal Table Entry Words 
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VFST - written by TELEX1 , 1R0, 1TA 
read by lRI/or the primary file 



59 54 53 48 47 



36 35 



24 23 



12 11 





EQ 


First 


Current 


Current 


POT 


EQ 


Prim- 


Track 


Track 


Sector 


FNT 


List 


Est. 
Ord. 


Primarj 






Pointer 



12 



12 



12 



12 



VROT - written by TELEX1, 1RO, 1TO 

read by 1RI, 1TA, 1TD, 1TO for the rollout file 



12 



12 



12 



12 



12 



Word 


EST 


First 




Field 


Sub- 


Status 


Count 


of 


Track 


A 


Length 


Status 




Rollout 


Rollout 












File 




/!.,.. 









^absolute FL flag; if not set then 
FL is in units of 100B 



Sub- status - 




LIST (normal) 


= 


LIST (EOR, EOF) 


= 1 


STATUS. F) 


= 2 


With input to 1RI, 


sub- status is formatted 


LLL LOO 001 SSS 


where. 




L = 


level number 


I = 


interrupt 


S = 


1 for EOR status 


= 


2 for EOF status 


= 


3 for EOI status 



Status - 



Bit 



Value 



TELEX in control 








SYSTEM in control 





1 


Job in system 


1 





Job to be rolled in 


2 




Job awaiting input 


3 




Output available 


4 




LIST or STATUS, F 


6 




Multi- terminal 


7 




Suspended 


9 




Purge files 


10 




error on last oneration 


11 


1 



Figure 13-13. Terminal Table Entry Words (continued) 
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The following three words, VDPT, VCHT, and VDCT are used by 1TD to maintain current 
information for the terminal. The main loop of 1TD will read these three words into PP memory 
at direct cells DP, CH, and DC corresponding to VDPT, VCHT, and VDCT. When the main 
loop jumps to the appropriate routines, they will use these direct cells instead of reading from 
CM. When control is returned to the main loop, it wiii write these direct ceils back to CM if 
necessary. VDCT is mainly used for communication with TELEX. This word is interlocked by 
TELEX thusly. K byte 4 is not clear, then this terminal is being processed by 1TD. When 
byte 4 goes clear, then 1TD is done and TELEX can use the information to continue activity 
for this terminal. 
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written by 1TD only- 
read by TELEX1 and 1TD 



Byte 


Byte 1 


Byte 2 


Byte 3 


Byte 4 


First 
Pot 


Current 
Pot 


Pot 
Position 


Control 

Flags 


Routine 

Address 



Byte - First Pot of input line. 



Byte 






Byte 2 - Position within Pot as follows: 

Bits Meaning 

9-11 First word in first pot of input line 

8 Input initiated 

7 Next input pot requested 

4-6 Current word in current pot (0-7) 

0-3 Character number in current word (1-12B) 

Byte 3 - Control flags as follows: 

Bits Meaning 

4-5 Terminal dependent 

3 Binary transmission 

2 Transparent input 

1 ASCII input 

Odd parity 



Byte 4 - The address of the PP driver subroutine which is currently 
processing the terminal. 



VCHT - read and written by 1TD only 



Byte 


Byte 1 


Byte 2 


Byte 3 


Byte 4 


Buffer 


Character 
Count 


Scratch 


Input 
Character 
Count 


Output 
Character 

Count 



Byte - During input, buffer holds the upper (even) character of byte 

until the next character is received at which time both characters 
(one byte) are stored into a pot. During output, buffer contains 
the driver subroutine address. 

Byte 1 - Total character count of line being processed. 

Byte 2 - Scratch and reentry address for polled terminals (TRANEX) 
type) . It most often contains the current input or output 
character for non-polled terminals. 

Byte 3 - Total number of characters received from terminal. 

Byte 4 - Total number of characters transmitted to terminal. 

Figure 13-13. Terminal Table Entry Words (continued) 
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VDCT - written by TELEX1 and 1TD 
read by TELEX1 and 1TD 



Byte 



Byte 1 



Bvte 2 



Flags 



Control In- 
formation 



AUTO or 
MONITOR 



Byte 3 



Access 
Level 



Byte 4 



Next 
Message 



Byte - Flags as follows: 



Bit 

48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 



Value 

0001 
0002 
0004 
0010 
0020 
0040 
0100 
0200 
0400 
1000 
2000 
4000 



Meaning 

Tape Mode 
Auto Mode 
Text Mode 

Transaction Mode 
Monitor Mode 
Read Data Mode 

Input Requested 

User Logged In 

Interrupt Complete 

Driver Request from TELEX 1 Byte 4 
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Byte 1 - Terminal Control Information as follows: 

Bit Values Meaning 

0-2 0-7 First word of output line in POT 

3-7 0-37B User defined carriage return delay 

8-9 0-1 Line type = Answerback type 

1 = Identification type 
10-11 Not used 

Byte 2 - In AUTO mode, the line number increment. 

In MONITOR mode, the terminal number of the terminal being 
monitored (i.e., the monitoree) . 

Byte 3 - Access Control Flags = lower 12 bits of access word defined 

in VALIDUX file for this user. Refer to the Installation Handbook 
for procedures to establish the access word. There are ten access 

bits defined in the system. 

• CPWC (bit 0) User may change his password 

• CTPC (bit 1) User may use the ACCESS commands 

• CLPF (bit 2) User may create direct access permanent files 

• CSPF (bit 3) User may create indirect access permanent 

files 

User may have system origin capability from 
any job origin if the Debug option is turned on 
by the operator 

User may access system files (common) 

User may request nonallocatable devices (for 
example, magnetic tape units) 

Allows use of system without entry of charge 
or project number 

Terminal Table Entry Words (continued) 
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e CSOJ (bit 4) 

• CASF (bit 5) 
e CAND (bit 6) 

• CCNR (bit 7) 
Figure 13-13 



• CSRP (bit 8) User may issue auxiliary device commands 

• CSTP (bit 9) User may access special transaction functions 

Byte 4 - First POT of an output message assignment or Driver Request 
Function Code (Byte 0-bit 59 flag). (Refer to paragraph 13.5. 3 
BGI - STT Subroutines) 

VSTT - written by TELEX1 

read by TELEX1. 1TA. 1TD. 1TO 



Byte 



Byte 2 






Flags 



First Pot 
Source 



Command 
Index or 
Pot Count 



RES- 
ERVED 



SYS 



Queued 
Output 



POT pointer 



Byte - Flags as follows: 



Bit 



Value 



48 


0001 


49 


0002 


50 


0004 


51 


0010 


52 


0020 


53 


0040 


54 


0100 


55 


0200 


56 


0400 


57 


1000 


58 


2000 


59 


4000 



Meaning 



/ 



Log- out in progress 

Log-out abort flag 

Warning issued 

Run complete message 

Sort flag 

Time limit flag 

Job complete flag 

Input lost or job not started 

Not used 

Charge number required 

User limits or alternate PF device 

Disable terminal control 

Byte 1 - First pot of source line input. This byte, along with byte 2 (pot 

count), is used in subroutine DMP to dump POTs to disk as input is 
received by calling 1TO. 



The index is set 



Byte 2 - POT count or index into command table, TCOM . 
by subroutine SCT. 

Byte 3 - Non-2ero if files lost on RECOVER command or, 
SYS = current system in control 

* Null 3 * not used 6 * Access 

1 = Basic 4 * Execute 7 = Transaction 

2 = Fortran 5 * Batch 

Byte 4 - POT pointer to a queued output message. That is, if a message is 
already in VDCT and not yet processed, the next message is queued 
by using byte 4 of VSTT. If another message must be assigned, it 
will be lost. See subroutine ASM. Normally, this byte is zero. 



Figure 13-13. Terminal Table Entry Words (continued) 
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Table 13-4 is a summary of the terminal table entry. 



TABLE 13-4. TERMINAL TABLE ENTRY SUMMARY 



Name 


Word 


Written by 


Read bv 


VUIT 





*TELEX. 1TA 




VFNT 


1 


*TELEX, 1RO 


1RI. 1TA 


VFST 


2 


♦TELEX, 1RO. 1TA 


1RI 


VROT 


3 


•TELEX. 1RO, 1TA 


1RI. 1TA, 1TD 


VDPT 


4 


1TD 




VCHT 


5 


1TD 




VDCT 


6 


•TELEX. 1TD 




VSTT 


7 


•TELEX 


1TA, 1TD 



•The name TELEX refers to any of the three overlays comprising TELEX. Any routine 
which writes a word also is assumed to read that word. 



13.3.4 



Transaction Word Table 



The transaction word table provides TELEX/ TRANEX communication and is pointed to 
by VPTP and contains a one-word entry for each transaction terminal. Figure 13-14. 
shows the entry format. 



Byte 



Byte 1 



Byte 2 



Byte 3 



Byte 4 



Retry 
Count 


Status 
Flags 


Output 

Pot 

Chain 


Message 
Sequence 


Terminal 
Address 



Status Flags-: 



Symbol Bit 



UTOB 
UTMB 
UAMB 
UWOB 



47 
46 
45 
44 



Meaning 

Terminal off 
Terminal malfunction 
Terminal waiting for message 
Terminal waiting for output 



Figure 13- 14. Transaction Terminal Word. 



These words are written by TELEX Transaction routines and read by the driver, 1TD. 
The changes to the terminal table for NKDORF transaction lines are: 



VCHT 



VDPT 



Byte 1 
Byte 2 
Byte 3 
Byte 4 

Byte 3 



bit 5-11 time out count 

reentry address (i.e., index into protocol sequence). 

block check character 

terminal number 



bit on - retry in progress 
bit 3 on - output sent 



bit 4 on - input received 
bit S on - sequence error 
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13.3.5 POT Link Table 

The POT Link Table (PLT) controls the use of POTs (8 word buffers). Its layout is shown 
in Figure 13-15. 



. Byte 



VPLP+0 
*1 
+2 

i 

Bvte 4 - 



Byte 1 



Byte 2 



Byte 3 



RES = Reservation flags 



000 000 001 



111 

ITU 






Byte 4 



77?? 


0002 ij 


0003 2 


0004 3j 


0017 


0005 4 


0000 sf 


0007 S 


0000 ?j 


0017 


0000 10 


0012 lli 


0013 12 


001'4 13) 


0007 


T 



sot in byte 3 reserved; = free POT 

A*pot in byte 2 reserved: = free POT 

^pot in byte 1 reserved; = free POT 

- pot in byte reserved; * free POT 



Figure 13-15. POT Link Table 



Each byte (0-3) represents a POT, an 3-word CM buffer starting at VBMP. Bytes 0-3 
contain a link to the next POT in the chain. The last POT in the chain is indicated by a 
zero byte. POT zero is always reserved and LINKs to 7777. Each PLT byte has the 
following format: 



Example: 



11 



2 10 



word link 



ts 



^byte link 

In Figure 13-16 sample table, pots 1-5 are reserved and comprise one chain. 
POTs S and 7 comprise another chain. POT 10 i3 free. POT 11 is the start 
of another chain. 



13.3.8 



Internal Queues (TRQT) 



.All internal queues are built at assembly time in a "table of queues. " This table consists 
of all the queues that may have requests in the re-entry table. The following is a list 
of valid queue names in the "table of queues. " 



WCMQ 
TIMQ 
JOBQ 
SOHQ 


- Wait Completion Queue 

- Time Delay Queue 

- Job Queue 

- Sort Queue 


ITAQ 
ITOQ 
PFMQ 


- ITA queue 7 

- ITO queue > PP r 

- PFM queue ) 
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The PP request queues are one-word entries in the "table of queues, " while the other 4 
are two-word entries. The format of the entries is shown in Figure 13-16. 



12 



12 



12 



12 



PP 


1 

P 1 00 


FC 


TN 


PP 



One 
Word 



where : 

PPP = 1TA, 1TO. or PFM 

FC * Function code 

TN = Terminal number 

PP = Pot pointer 



word 1 
word 2 

where: 



2CCC 


0000 


00NN I NN:00 


YYYY 


0000 


0000 


TTTT 


TTTT 


TTTT 



CCC = number of entries (packed format) 

NNNN = first terminal entry (index into Re-entry Table) 

YYYY = last terminal entry (index into Re-entry Table) 

T - T * resource control count 



Figure 13-16. Table of Queues Two-Word Entry Format and One Word 

NOTE 
Each queue has an associated string of entries in the Re-entry Table. See 
Figure 13-19. 

13.3.7 Re-Entry Table (VRAP) 

The TELEX subroutines use the reentry table to have control returned or functions performed 
for them when a set of conditions are met. The table consists of one word for each terminal 
with one of the formats shown in Figure 13- 17. 

jooj 



1. 



0000 



0000 



0000 



0000 



0000 



No reentry conditions 



2YYY 


xxxx 


xxxx 


pppp 


NNNN 



YYY - Index to TRRT (table of reentry processors) 

XXXX XXXX = anything 

P2=PP * POT pointer for further params 

NNNN = LINK to next entry in fee queue of this type (see TSR) 









17 







0000 


0000 


0000 


00| NN 


NNNN 





NN NNNN = pot address of stacked entries 

Figure 13-17. One-Word Re-entry Table Formats. 
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Each entry in the Re-entry Table contains an index to the Table of Re-entry Routine 
Parameters (TRRT). 

13.3.8 Table of Re-entry Routine Parameters (TRRT) 

This table ia built at assembly time. It consists of entries that direct further processing 
based on entries from the re-entry table and on completion of certain sections Entries 

the format shown in Figure 13-18. 



59 48 47 36 35 


18 17 





XXYY | ZZZZ 


EEEE 


EE:NN 


NNNN 



where . 

XX = index to TRQT (Queue Table). If XX=0, no resources are required 

except for a peripheral processor, possibly. 
YY = function code for called program. 

ZZZZ - function processing address relative to TSRPROC. 
EEEEEE= error return address. 
NNNNNN= normal return address. 

Figure 13-18. TRRT Format 



The COMMND macro parameters are: 

COMMND MACRO PROC, SYSR, NPRO, ERRA, FUNC 

Z2ZZ=PROC ■ entry point of routine to process this command. 

, . XX=SYSR = the queue that the request is to be placed in. CWCMQ, TIMQ, JOBQ, SORQ, 
IXAQ, ITOQ, or PFMQ). 

NNNN=NPRO = normal return address. 

EEEE=ERRA = error return address . 

YYY=FUNC - function code to be passed to the called program 

Example of COMMND macro: 

Ihis example shows the use of the COMMND macro and how easily a call is made to 

a* 

generate a queue entry. 

COMMND INP6,WCMQ,INP6,INP6 

INP6S is the symbol for this word in the table of reentry routines. 
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Example of COMMND INPS,WCMQ, REENTT,ERR: 
Log in code 



TTM 



REENTI 



ERR 



code 

J 

CALL SPRR 




SX5 


INP6$ 


EO 

i 


PCSU 


good return 




error return 



set up ITA call, now - can't wait for 
response so queue up for this terminal 
and return later 

command address 
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Now to make the WCMQ queue entry: 



SX5 



INP6$ SPECIFY COMMAND TABLE ENTRY 
PCS4 MAKE QUEUE ENTRY 



INP6 BSS 



NORMAL AND ERROR RETURN ADDRESS 



In general, queue entries are made in this manner throughout TELEX 

Figure 13- 19 shows the relationship between the Table of Queues", the Re-entry Table, and 
the Table of Re-entry Routine Parameters. Notice that there is one queue entry per 
terminal . 



word 1 of WCMQ from TRQT 



2003 



first 



^ 



count of entries 



last 



Re-entry Table 



(VRAP • 

terminal 1 
terminal 2 



terminal 
n-1 

terminal n 

TRRT 
Word 



TRRT index 



TRRT index 



TRRT index 



Parameters 



Pot Ptr 



Pot Ptr. 



Pot Ptr. 



link 



TRQT 
index 



FCN 
code 



function 
processing 
address 



error 
return 
address 



code 



normal 
return 
address 



"T" 

code 



set up 

by COMMAND 

macro 



Figure 13-19. Table Relationships 
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13.3.9 Queue Processing 

Processing of queue entries is done by the PCS subroutine. As entries are completed, PCS 
extracts the normal or error return address and jumps to it. Making queue entries is 
done by a jump to PCS4 or PCS6. Before returning to a routine, PCS calls SSP which 
sets up the following registers: 

AO = FWA of user's terminal table entry 

B2 = terminal number 

B3 = POT pointer (extracted from byte 3 of entry in Reentry Table) 

B4 = FWA of pot pointed to by B3 

X7 = bits 24-47 of Reentry Table entry 

These A and B registers are generally not changed within the various subroutines of TELEX 

13.3.10 TELEX Routines 

The following is an outline of the subroutines comprising TELEX: 

• MUXP - multiplexer table (RA + 10 IB) 

• TRQT - table of queues: 

WCMQ ITAQ 

TIMQ ITOQ 

JOBQ PFMQ 
SORQ 

• TEL - control loop. Calls the following: 

DRI TDQ PPU 

STM CSF TSR 

CCS SOR SPR 

RPC SCH CTB 

e CCS - Process requests to handle output to TTY by calling the following subroutines: 

DRT SDT 

ASO CDT 

DSD 

« CSF - Check SALVARE file user time out 

• DRI - Process driver (1TD) requests by calling the following subroutines: 



AOD 


DLO 


IAM 


MA L 


SKY 


CSC 


DRP 


ITM 


MTN 


SPT 


CLI 


DRT 


LOF 


RES 




DIN 


HUP 


LPT 


RIN 
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PCM - Process terminal commands (called from CLI, AUT) 
Calls following subroutines: 



ACC 


DIA 


LIS 


REP 


SUB 


ASC 


EDI 


MTR 


PER 


TAP 


ATT 


FDP 


NOR 


ROT 


TER 


AUT 


GET 


NOD 


RUN 


TXT 


BAT 


HEL 


NOS 


SAV 


UNS 


BIN 


HDP 


PAC 


SOF 


UNU 


BYE 


LAN 


PAR 


STA 


XEQ 


CLR 


LEN 


PFC 


STO 




'omnia 


nd Profce 


ssing Routines: 




BJB 


IEX 


IUA 


IAF 


PUR 


BJS 


INJ 


PBS 


PFF 


RDY 


EJB 


IPF 


PSS 


PFM 




IDT 


IPL 


DAF 


PFP 





• PCS - Process queue entries 
e PPU - Process PPU requests 
e RPC - Refill POT chains 

• SCH - Build job queue entry for scheduling a job 

• SOR - Set up for scheduling SORT job 

• SPR - Call 1TA to adjust field length 
» TDQ - Process time - delay queue 

• TSR - Process WCMQ. Reenter the following: 



DCR 


ITA 


MJE 


SRE 




HNG 


I TO 


MTO 


SSO 




ICH 


JOB 


REC 






INP 


LIN 


SEN 






iroutin 


es including: 






ABT 


CPF 


GPL 


MQE 


SFL 


BRQ 


DAP 


GQE 


MVA 


SLF 


CCM 


DMP 


GRT 


06S 


SRC 


CFL 


DPT 


GTA 


PCB 


SRR 


CJT 


ENP 


GZP 


RPL 


SSP 


CLE 


GEM 


ISH 


RPT 


TPF 


COI 


GFN 


LTT 


SAF 


UPF 


COP 


GFS 


MDA 


SCT 


UQS 



Transaction routines including: 

a. TRANEX driver routines 

b. TRANEX interface routine 

c. general subroutines 
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13.4 TELEX2 - TERMINATION 

TELEX2 performs termination procedures for the TELEX subsystems. It is called whenever 
an abnormal condition is detected or when the operator types 1 . STOP to drop the subsystem. 

When an abnormal condition is detected within TELEX1 processing, a jump to the abort 
subroutine (ABT) is executed. If sense switch 3 is OFF, ABT continues or control is 
returned to the calling routine. If switch 3 is ON, ABT issues the message: 

TELEX ABNORMAL - XXX 

where: XXX is the name of the subroutine calling ABT. 

After issuing this message, the ABORT macro is used to abort the control point. 1AJ senses 
the EXIT control card, the next control card (TELEX2) is found, and lAThas the termination 
routine loaded. Loading of TELEX2 starts at location ABT. This overlays the least important 
code of TELEX1 and leaves the tables and queues untouched. Basically, TELEX2 logs out ail 
active users so that there will not be any time- sharing jobs left in the system. After 
issuing system statistics, 1TD is called to restart the time- sharing subsystem depending 
on sense switch settings. 

13.5 MULTIPLEXER DRIVER 

1TD performs communication between TELEX and terminals (accessed via the 6671 
and S676 multiplexers) and the KRONOS Stimulator. It has the capability to communicate 
with most ASCII compatible terminals and correspondence code compatible terminals such 
as the IBM 2741 and NOVAR 541, 713, NIXDORF terminals, if the multiplexer has the 
required options installed. 

1TD processes up to 512 (10-character/ second) terminals. The number of terminals for 
which performance can be guaranteed will decrease as the terminal speed is increased 
In any event, the total driver capability is 5120 characters /second The maximum 
terminal speed which may be accommodated is 60 characters./ second. 

Terminal communication is processed in a half-duplex mode. A line is generally the 
unit of transmission in each direction. Interruption of continuous output is provided along 
with an input line and character deletion facility. 

Communication between 1TD and TELEX is accomplished by means of a circular request 
queue provided by TELEX. 1TD inserts a request in the queue and TELEX removes the 
request as it is processed. 
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Terminal control operations for ASCII terminals include: 

1. To complete an input line, type the RETURN key. A line feed is not needed, 
since the driver issues one to the terminal, 

2. To delete or ignore an input line, type the ESC key 

3. To delete a previously entered character, type the UNDERLINE (BACK ARROW 
on some Model 33 teletypewriters. 

4. To terminate output, type the BREAK key, or the S key. 

5. To interrupt output, type the I key. Output may be resumed by typing P followed 
by RETURN. 

Terminal control operations for correspondence code terminals include: 

1. To complete an input line, type the RETURN key. 

2. To delete or ignore an input line, type ATTN. 

3. To delete the previously entered character, type BACK SPACE. 

4. To terminate output, type the ATTN key. 

1TD consists of two routines: 1TD and 2TD. the 1TD routine is the initialization (and 
termination) routine that loads the 2TD overlay. The 2TD overlay is normally loaded and 
executing in the PP while the TELEX subsystem is servicing terminals. Four other over- 
lays are assembled with 1TD. These are the translation tables for the various terminals 
listed in Table 13-5. 

TABLE 13-5. TRANSLATION TABLES OVERLAYS 



Overlay 


Terminal Type 


9JA 
9JB 
9JC 
9JD 


ASCII terminal 
Correspondence / text 
Correspondence 
Memorex 1240 /APL 



Figure 13-20 shows the multiplexer servicing concept as being similar to the hardware 
slot and barrel concept for peripheral processors. Notice that up to eight multiplexers are 
serviced by the driver and that each port is allotted a time slice in which the driver performs 
I/O and required overhead. 
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PORT 63 




EXECUTION SLOT 



PORT 1 



Figure 13-20. MUX Servicing Concept 
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13.5. 1 



Driver Initialization (1TD) 



The multiplexer driver is initialized by the overlay 1TD. This overlay consists of three 
USE blocks: 

1. MAIN - initialize TELEX control point 

2. PRESET - load 2TD 

3. RESIDENT - code resident during execution 

The lengths of these blocks are determined by the difference between their last word 
address and their first word address as shown in Table 13-6. 

TABLE 13-6. USE BLOCKS LENGTHS 



Last 


First 


Description 


MANE 

RESE 

PRSE 


MANF 

RESF 

PRSF 


length of MAIN 
length of RESIDENT 
length of PRESET 



These three lengths are added and the sum is subtracted from 4096 to establish the origina- 
tion (ORG) address. The multiplexer input buffer (IBUF) is defined in PRESET and must 
follow the PP resident translation tables. A check for this overflow condition is made 
at the end of the 2TD overlay. At this time, there are 52B PP words between IBUF and 
I the end of the translation tables. (August 1973) 

Overlay 1TD is loaded when the operator, types TELEX to 1) (start the time-sharing 
executive) and 2) (during termination to perform certain post processing operations). 
That is, 1TD is called by 2TD from the DRP subroutine. Since 1TD is loaded above the 
| translation tables, much of 2TD is overlayed when it calls 1TD. Routines overlayed 
include some write mode processing (WTM), all polled line processing routines, and all 
cf the utility subroutines. In addition, the translation tables and the multiplexer input 
buffer are overlayed as well. Figure 13-21 shows the relative load addresses of the three 
USE blocks comprising 1TD, as well as the 2TD overlay while executing 
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2TD during 
execution 




ITD 
Loaded 










100 


output buffers 


1077 

1 1 nn 






MGR _ __ 

RWC 




RDM 




WTM 




MAIN 




PTP 




Utility Subs 




Translation 
Tables 


COMPRSI 






PRESET 








Input Buffer 


resf" 

7777 


COMPMRQ 

RESIDENT 

i 


7777 


Resident 
Code 



Figure 13-21, 1TD/2TD Memory Maps 

Figure 13-22 is aflowchart showing an overview of the initialization processes in blocks 
MAIN and PRESET. RESIDENT code is used by 2TD during termination processing. 

Data in the multiplexer input and output buffers within 2TD consists of an 8-bit character 
per port along with control bits as shown in Figure 13-23. 
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MAIN 




LCT 



Load CM 

Resident 

^ translation 

tables 



STA 



Set transla- 
tion table 
^addresses 



T 



Set other 

table addressei 



T 



Allocate 
TRANEX 
buffer if 
needed 



Set first 
TELEX 
terminal 
number 



Preset start 
address for 
each terminal 
in DP +4 



PRESET 
— *-fpRS\ 

/ RPP 
Load 2TD 



X 



Relocate all 
addresses to 
absolute 



X 



Load PP 
resident 
translation 
tables 



Clear 
output 
buffers 



RA + 100 
RA^1077 



AVTq enter 
mam 



loop 



Figure 13-22. MAIN and PRESET Overview 
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Input from 6676 MUX 



11 


10 


9 


S 


7 


6 5 4 3 


2 


1 n 


1 


1 I 

1 1 

i 1 




i.l i 




1 1 


1 


. , , i j i . 




1 "1 



■ Character reject - MUX would not send character 
to terminal; 1TD repeats output 



\ V- 



TTY On-line 

Data lost - new character sent before old character 

accepted. 1TD is getting behind . 

■Valid Character 



Outout to 6676 MUX 



11 


10 


9 


8 


7 


6 5 4 3 


2 


1 















1 l 








i— ■■ -i- 1 







bit 11 

bit 11 
bit 10 



'Valid Character 

■ Turn TTY off 



Figure 13-23. Input/ Output Buffers. 



Note 
Further information is available in the following manuals: 

Title Publication Number 



Control Data 6671/6671-2 

Data Set Controller Ref. Manual 

Control Data 6676-A 

TTY Multiplexer Ref. Manual 

Control Data 6676-B/C 

TTY Multiplexer Ref. Manual 



60334600 



38706000 



38707800 



Figure 13-24 describes the logical breakdown of the 2TD driver while executing. 
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I 
I 



Address 



77 

OBUF = 100 

1077 
PPFW=1100 



EXI1-8 
MGR 
RWC- 



_ ^IGR^.term J _rnanager 

RWC - Read /Write Control 



Loaded 
with 
1TD 
overlay 



TINT ■ 
TOPT 

'iBUF - 



Direct Calls 



8 Output Buffers 



Main Loop 
Service next MUX 
and Stimulator 



Reentrant Routine Returns 



Read Mode 
MUX-*-POTs 



Write Mode 
POTs-*MUX 



Polled Line 
Processing 



Utility Subroutines 
and exit processing 



Translation Tables 
Input/ Output 
9J(x) 



Input Buffer 
100B Words 



Resident Code 
COMPMRQ 
RPP 

Tables: 

TEQN 

TNTD 

TTTC 

TITA 

TOTA 



Qualifier 



1TD 



CTL 

RDM 
WTM 
PTP 



1TD 



Figure 13-24. 2TD Memory Map 
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13.5.2 



Re -Entrant Routine Returns 



The re-entrant routine returns are eight "entry points" which are jumped to by any subroutine 
which cannot complete its function in a single time slice. The RETURN macro is the most 
common method used throughout the listing for the purpose of setting a return address 
Control is returned at the next instruction or to another specified routine address. For 
instance, 

RETURN EXI7 

enables control to be returned at the next instruction; while 

RETURN EX23, LIN 

causes control to be set to the LIN subroutine for the next time slice for this port. In 
any case, the EXI(x) specifies a reentrant return address. If x is odd, the reentry address 
is in the A-register and stored in DP+4 (i.e , VDPT, byte 4) . If x is even, no return 
address is given, and control is returned to the previous return address in DP -4. The 
reentrant return addresses and terminal table words updated are whown in Table 13-7. 

TABLE 13-7. ADDRESSES AND WORDS 



Reentrant 


Terminal Table Word(s) Written 


Return Address 


j 


EXI1, EXI2 


VDPT 


EXI3, EXI4 


VDPT, VCHT 


EXI5, EXI6 


VDPT, VCHT, VDCT 


EXI7, EXI8 


VDPT, clear byte in output buffer 



Direct Cell assignments are explained in the listing. However, it is worth noting that 
during execution VDPT, VCHT, and VDCT are available in direct cells. VDCT is read 
and updated only when necessary to minimize CM reads and writes. 

The main loop controls the advancement to the next multiplexer, performs MUX I/O, 
checks for STIMULATOR processing, and enters the manager (MGR subroutine 
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Process Subroutines 



The MGR subroutine processes individual ports and satisfies requests from TELEX A 
flowchart of MGR is shown in Figure 13-25. The symbol qualifier CTL contains the follow- 
ing routines: 
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MGR 

CIS 

INT 

CTO 

DIN 

HUP 

OFL 

RWC 

DTT 

LIN 

RAB 

1TD- 

TFR 

1 



2 
3 

4 

5 

6 

7 

10 

11 

12 



BFI 

CFD 

HUP 

IIP 

LGI 

SAS 

SNM 

SOP 

SFD 

STT 



terminal manager 
check interrupt status 
process interrupt 
check time out 
dial-in processing i 

hang up phone / 1* 

process user off line 
Read /Write control 
determine terminal type 

process login_ 

read answerback drum J 

function codes for the processor TFR 2* 

process TEI£X functions with the following subroutines: 

begin input 

clear "full duplex" flag in VDPT ITD function values for BYTE 4 of VDCT. 

hang up phone 

issue input prompt (i.e., "?") 

process login 

set ASCII mode flag in VDPT 

set normal mode 

set odd parity 

set "full duplex" flag 

set terminal type 



| READ MODE 

The symbol qualifier RDM contains the following read mode subroutines: 



BRD - binary read 

CRD - correspondence read 

ARD - ASCII read 



APLtype, NOVAR 



These three routines call RTC which translates the input character and stores it in a POT. 
If the input character is a "special" character, one of the following subroutines is called: 

ESC - process escape codes 

CRT - process carriage return 

DLN - line delete 

DPC - delete previous character 

NLI - null input 

CSF - case shift 

NWL - new line 

EOT - end of transmission 

BRK - break 

CRT, BRK, and NWL call EIL for end-of-line processing which calls: 

CLI - command line input 
SLI - source line input 



CLI calls: 

ACL 

or CCL 



ASCII end of command line 
Correspondence end of command line 



SLI calls: 

ASL 
or CSL 



ASCII end of source line 
Correspondence end of source line 
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i* V'DPT word, DF+4 gets one of these address, 

2* TELEX requests 1TD to perform certain functions by setting bit 11 of Byte of VDCT and the 
function code in Byte 4 . 



97404700C 13-33.1 | 



General subroutines used by RDM are: 

ITM - issue terminal message 

NIP __ - no input POT available 

DLO " - process lost data 

TIC - translate input character 

WIC - write input character 

Normal read mode processing starts with the RDM subroutine which sets the return 
address in DP-4 to BRD, CRD, or ARD. As characters are received from the multiplexer, 
they are processed by RTC which calls TIC to translate them, then calls WIC to write them 
in POTs. The normal exit is to EXI4. Figure 13-26 shows the general relationship of the 
read mode processing subroutines. 

The symbol qualifier WTM contains the subroutines used for write processing. These 
subroutines are structured similar to RDM subroutines and include: 

BWT - binary write 

CWT - correspondence write 

AWT - ASCII write 

These three subroutines call WTC to write the terminal character by using subroutines 

ROC - read output character from pot 
TOC - translate character 

A "special" character is processed by one of the following routines: 

NLO - null output 

ANL - ASCII terminal new line 

ACR - ASCII terminal carriage return 

CNL - correspondence end of line 

CCR - correspondence carriage return 

CLF - correspondence line feed 

CBS - correspondence backspace 

Other write mode general subroutines include: 

CMM - process monitor mode 

SOC - set output control 

SRC - send repeated character 

SOC restarts a job to get more output and processes output control bytes by jumping to one 
of the subroutines listed in Table 13-8. 
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MGR 
pick up 
next terminal 




yes 




pick up 

INPUT 
from MUX 




No 



read 

VDPT/VCHT 




read VDPT 
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No 



:es 
TTsl check for 
interrupt 



Yes 





No 



(A) = input 
from MUX 



enter 
reentrant 
routine (DP- 

4) 



(VDPT - Byte 4) 



read VCHT 




process 

off-line 



Figure 13- 25. MGR Flowchart 
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(rdm\ 



Note: A line with two headed arrows 
represents a subroutine 
entered via RJM instruction 




Figure 13-26. Read Mode Processing Subroutines. 
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TABLE 13-8. CONTROL SUBROUTINES 



Control 


Subroutine 




Byte 


Name 


Function 


0000 


EOB 


end of line 


0001 


EOB 


end of block 


0002 


EOB 


•end of block 


0003 


ATI 


AUTO input 


0004 


LOF 


log off user 


0005 


TPI 


set transparent input (allows all characters 
to be transmitted to the CPU program) 


0006 


BNI 


set binary input 


0007 


BNO 


begin binary output 



The relationship between the write mode subroutine is shown in Figure 13-27. 



fwTM 

^F Set (CH) = Write Processor 




WTC 



-*WTCX 



WTC 



Note: A line with two arrows indicate 
a return jump. 



Figure 13-27. Write Mode Processing Subroutines. 



| 13-42 



97404700B 



The symbol qualifier PTP contains the routines used to process polled lines. These 
include: 

SPL - sense polled lines 

RPR - read poll response 

PTR - process terminal response 

SSC - set sequence count 

Utility subroutines are under the symbol qualifier 1TD and are general subroutines used 
by the other routines described previously. The utility subroutines are as. follows: 

BUP - back up pointers 

CUT - clean up terminal tables 

ERQ - put entry in TELEX's request queue 

RLT - read link table to get next pot in chain 

RPC - read previous character in pot 

SCA - set control address (for instance, RDM uses this to set read routine 

BRD, CRD, or ARD depending on translation table) 

WTO - wait time out 

Exit processing routines include: 

MXE - process multiplexer error 

DRP - process driver exit (call RESIDENT code set up by 1TD 
at initialization time) 

13. 6 1TA - TELEX AUXILIARY ROUTINE 

1TA processes functions for TELEX which require PP action. The functions allowed are 
listed in Table 13-9. 

TABLE 13-9. PROCESS FUNCTIONS 



Overlay 


Function 


Routine 


Description 


Name 


Code 


Name 






1 




Unused 


1TA 


2 


PFS 


Purge file space 


3TA 


3 


TFL 


Adjust TELEX field length 


3TB 


4 


RTJ 


Return terminal job 


3TC 


5 


CRF 


Create rollout file - login 


3TD 


6 


TLP 


Terminal logout processor 


3TF 


7 


FLS 


Get file length in sectors 

uivuacu via. i^il. *\ vj i. n uumtiicLiiu 


3TF 


10 


SFD 


Secondary file descriptions 
Invoked via STATUS, F 


3TG 


11 


TIM 


Time status command 




12 




Unused 


3TG 


13 


TIM 


Increment time limit 


3TL 


14 


IPF 


Initiate primary file 


3TH 


15 


RFP 


Recovery file processor 


3TI 


16 


SJS 


Schedule SORT job 


3TJ 


17 


GST 


Gather terminal statistics 


3TK 


20 


CUS 


Clean up SALVARE file 


3TM 


21 


CJS 


Check job status 
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TELEX calls 1TA in one of two ways shown in Figure 13-28. 



Group Request 



-A group of requests are stored in POTs. 
The input register format is: 



59 


42 


41 36 


35 30 29 


12 


11 


1 T A 


CP 





Return Address 


POT 
Pointer 


18 


6 6 18 12 


IR 


IR+1 


IR+2 


IR+3 


IR+4 



where: 

Return Address = Upper 24 bits of the word specified are set to zero upon completion 

of all requests. 
CP = Control Point Number 

POT Pointer = POT containing the list of requests 
The requests are one word each with the following format: 



59 



36 35 



24 23 



12 11 







Unused 


FC 


TN 


ARG 



12 



12 



12 



12 



where: 

FC = function code 

TN = terminal number 

ARG = POT pointer or request type 

The list of requests is terminated with a zero word. 



,35 



Single Request - A single request is denoted by setting bit 2 in the input register 
which is formatted: 



1 T A 


CP 


4000B + 

FC 


TN 


ARG 


IR 


IR1 


IR2 


IR3 


IR4 



where: 
CP 

FC 
TN 
ARG 



= Control point number 

= Function code 

= terminal number 

= pot pointer or parameter (depending on function) 



Figure 13-28. TELEX Calls To 1TA. 
1TA uses several bits in VROT of the terminal table. These bits are: 



Bit 



4 

10 

11 



Description 

Completion status bit 

Set to indicate recall function by TELEX 

Purge rollout FNT's 

Error return 



Figure 13-29 is the flowcharts of the initialization, execution, and termination of the 
control loop for 1TA. 
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1TA Initialization 



V 



Set Comple- 
tion Address 
(IR-2, 3} 

ITAE. 




Store POT 
Pointer 
(IR^-4) ITAA 



SPA 



Get Pot 
Address 



T 



Store Pot 
Address in 
ITAB 



Clear Single 
Request Flag 

2 35 of IR 



T 



Set ITAX 
to drop PP 

after complet- 
ing request 



Error Exit 




J- 



Set error and 
completion bits 
in VROT for 
this terminal 



ITA 




IITA2I LTA5 1 



Figure 13-29. ITA Control Loop 
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Get Next Request (1TA) 




Increment to 
next request in 
pot 




Read Pot 
Entry- 



Yes 




Set Return 
Address Word 
Complete 




Process Function Request 




Set error 
exit ERX+1 
ITAD 



Store Pro- 
cessor Add- 
ress & Name 
ITAD 




aet Terminal 
.Table Address 




Process 
Function 
LJM (ITAD) 




Figure 13-29. 1TA Control Loop (continued) 
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1TA Termination Routine - TER 

Entry - (FS - FS+4) = Primary File FST 
(CN - CN44) = Rollout File FST 
FP = First Pot of Message or data 
LP = Last Pot of Message or data 




Yes 



Set no output 
flag in Rollout 
File FST (CN 

-til 



T 



Write Primary 
file FST in 
VFST (pg ii) 



+ 



Write Rollout 
file FST in 
VROT 




Yes 



Assign Output 
function VASO 
to TELEX 



T 



PTN 



Call PP 
Monitor TSEIV 




2001 





LP 


FP 


Terminal 

Number 



Figure 13-29. 1TA Control Loop (continued) 
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Function 5 is used to create a rollout file for a time-sharing job. The format of the 
rollout file is given in Figure 13-30. 



System Sector Stuff 
Dayfile Buffer Pointers 
INPUT File FNT/FST 
Assigned Equipment 
Terminal Table Entry 



Control Point 
Area 



Dayfile Buffer 



FNT/FST Entries 



Terminal Output 



Job Field Length 



System Sector 



Figure 13-30. Time-sharing Job Rollout File 
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13.7 1TO - TTY INPUT /OUTPUT ROUTINE 

1TO is called by TELEX to process a queue of requests for terminal input and output 
which require disk accesses. The queue resides in POTs within TELEX'S field length 
The queue has been sorted by TELEX in order of equipment and disk addresses so as 

to Tninimi7P disk HmA Tf fhprp arp T»emie<a + a fnr* mnr^p than nno maca a+r>T*^ cta Aairif>a 

the entries are processed for the first device available. 



1T0 is also called by iRO to handle the first buffer of data on a rollout file. This data is 
passed to 1TO in a PP buffer. 1TO dumps the PP buffer into POTs and makes a VASO 

request to TELEX for that terminal. 

The input register format when 1TO is called by IRO as shown in Figure 13- 31. 



59 



IR+1 
42 41 



IR+2 



IR+3 



IR+4 



36 35 



24 23 



12 11 



(IR) = 



O 



CP 



BA 



TN 



18 



12 



12 



12 



where: 



fp - TTTT try nnntnnl -nnln+ r, ■,»-, Ua »• 

BA = Buffer address in PP of first .sector of output data 
TN = terminal number 



Figure 13-31. Input Register -IRO 



The input register when called by TELEX as shown in Figure 13-32. 



59 



IR I IR+1 | IR+2 | IR+3 

42 41 36 35 24 23 



IR+4 



17 



1 T O 


CP 


PP 





Return 
Address 



18 



12 



18 



where: 



CP = TELEX control point 

PP = POT pointer to first POT of requests 

Return Address = location of completion status word 



Figure 13-32. Input Register - TELEX 
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RC 


EQ 


TRACK 


W 





X 


FP 


TN 



12 



12 



12 



The request in POTs are one word entries with the format shown in Figure 13-33. 
59 54 53 48 47 36 33 27 24 23 12 11 



where: 
RC 

EQ 
TRACK 

W 

X 

FP 

TN 



Request code = Correction dump 

1 = Output data 
Equipment number 
first track of file if RC = 
current track if RC = 1 

number of words in last POT (0 means 10) 
W is meaninfgul when RC = . 
number of POTs to dump. RC = 
first pot of source or output 
terminal number 



Figure 13-33. POTs Entries 

Asa group of requests is completed, the above entries are updated by setting byte 2 
to the last POT to be dropped or assigned These requests are then written back in the 
same pot from which they came. 

The flowcharts of 1TO (Figure 13-34) show that it is broken down logically into 4 sections: 

• Preset or initialization 

• Main loop - get next request 

e ICH subroutines = correction handler if RC = 

• PRO subroutines to process output if RC = 1. That is data flow is: 

DISKh-POTs -»-TTY 
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1TO Initialization - PRS 




Set terminal 
number (IR- 
4) TN 

RPSB f 4 

1 



STA 



Set terminal . 
table address 



T 



Read 

VFST— «-FS 

VROT—CN 
VSTT-«-CM 




Kead one pot 
.of requests 
into EBUF 



z 



UPP 



Get next Pot 
Address 




Sort Requests 
into groups 
based on equip 

ment number 





DPP J Drop PP 



Figure 13-34. 1TO Flowchart 
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1TO Main Routine 
/LTO\ 



Select Group 
to Process 




SEI 



Position Pri- 
mary File to 
EOI 



POS 



Position Disk 
BQI 



'TESor TEC 

Post Process 
Last Re- 
S, quest 



STA 

Set Terminal 
Table Ad- 
dress 



Read 

VFST ►FS 

VROT i-CN 



Store Pot 
Pointer into 
Cell PP 




Process 

Source 

Lines 



Process 
Output 



Figure 13-34. 1 TO Flowchart (continued) 
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ITO10 - Common Return Point from ICH and PRO 




Set post pro- 
cessing address 
TEO or TES 




'TF.S nr TFQN 
Post Process 

last request 

I 

SPA \ 

set Request 
POT Address, 



Write Request 
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TELEX 



UPP 



Set next 
POT Address 




Set upper 
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IR = 



T 



Write IR at 
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to mark 
complete 




FTN 



Drop PP 




Figure 13-34. 1 TO Flowchart (continued^ 
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PRO - Process Output 
Disk-*-POTs — »»TTY 




LDB 



Load PP buf- 
fer from disk/ 



Search disk 
for requested, 
line / 

— F 



Set Post 
Processing 
address to 
TEO 



£ 




ITO 
10 



TEO - Terminate Output 




PDR 



Store --EOR-- 
-EOF-- in , 
buffer / 



T 



A 



LDP 

''Write PP — 
^ buffer into 
\ POTs 

/ UTT 

Update Term- 
inal Table 
VFST, VROT 



T 



Return 



Figure 13-34. ITO Flowchart (continued) 
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ICH • 

TTV- 



Correction Handler 
— »-PQTs *-DI3K 



^ 



Set number of 
POTs to dump 
(XX) PC 




XFER Data 
from pots to 
PP buffer 




Request 
tracks if 
needed 




Write buffer 
to Disk 



7s 

AvEn 



Write EOI 
Sector 



TES - Terminate Source Processing 




/ ftn y 

/Set end of \ 
\ track chain / 

\ UTKM-7 

F 



Set VROT 
Complete 
(Set 2°) 



f Return ^ 



Set Post 
Processing 
address to 
TES 




Figure 13-34. 1TO Flowchart (continued) 
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13.8 SOME QUESTIONS AND ANSWERS ABOUT TELEX 

Q. How does 1TD know what parity and transmission code a port is using before LOGIN 
has completed? 

A, The NETWORK or SIMFILE file specified all the known terminals. In lieu of one of the 
above, 1TD assumes all terminals are 100 band (10 cps) time sharing TTYtype. 

Q. What is $LDC issued by TELEX? 

A. The "$" Implies no local file load, this is a compiler call card issued by TELEX in 

response to a TTY user typing RUN or some similar call in the BASIC and other subsystems. 
There is no routine in the CLD or PLD named LDC. It is processed locally by 1AJ, who 
determines which compiler is requested and sets up the input file for it. The call is 
documented in the code and may be issued by any user. The subroutine CCL in TCS 
processes this card. The user may define a local file as LDC and load it if no 
"$" preceeds the call. 

0. What is the TT entry in VALIDUX used for and why? 

A. The entry is used for validation. If the entry is set, then this user must be on that type 
of device to be validated. The TERMINAL table defines what type of terminal is calling. 

13.9 SALVARE -TELEX RECOVERY FILE 

The SALVARE file is built during TELEX initialization time. VPST is set = 4, the number of 
pseudo terminals and VMNL is set to the active number of users, determined from inspection 
of the MUX entries by 1TD. 

During the INI21 code, the SALVARE file is built consisting of a two word entry per terminal. 
One word is needed per terminal so the file allows up to two users per terminal to be recovered. 
The situation can arise if the user at port x somehow is lost. Then a different user logs in at 
port x and is subsequently lost. The SALVARE file can be used to recover both of these users 
at a subsequent log in even at different ports. 

If this is a recovery, TELEX will check the SALVARE file and insure that the number of ports 
has not changed since the original start up of TELEX. If there is a change, TELEX will abort. 
This code is atINI25. 
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During operation in TELEX1, the main loop (see Figure 13-6) will call CSF. CSF will issue a 
1TA queue call to check the SALVARE file in 1TA routine CUS function 20. CUS will clear all 
entries in the SALVARE file over 10 minutes old. This call is made about every 3 minutes. 

1TA is a combination of functions to perform for TELEX. The important functions associated with 
the SALVARE are: 

1 . CUS - clean up file 

2 . TLP - terminal log out processor 

3. TRP - terminal recovery processor. This overlay contains the SALVARE format 
documentation . 

4. RFP - recovery file processor 

Since the SALVARE file is checked about every 3 minutes and entries more than 10 minutes old 
are eliminated, then: 

1 . A user that wishes to be recovered after losing contact must attempt recovery within 
10 minutes. 

2. In case of total system failure for over 10 minutes, any user wishing recovery after 
the system is revived must recover within 3 minutes. Otherwise, TELEX will clean 
up all entries, i.e., eliminate all entries within 3 minutes of TELEX recovery. 

Recovery is accomplished in the routine RFP and a description of recovery processes follow: 

OVERLAY (Recovery File Processor.) 
RFP - Recovery File Processor call is: 



24 



12 



12 



12 



IR= 



1TA 


15 


TN 


POT 



at call time 



Upon entry, IR+4 contains the parameter pot number. The pot contains the terminal table. 
IR+4 is set to the previous terminal number, which is recovered from parameter pot. 



24 



12 



12 



12 



1TA 


15 


TNN 


TNB 



IR= 

TNN = Terminal number now. 
TNB = Terminal number before. 

A. To recover a user the entry on the SALVARE file is found and information returned to 
terminal table. The entry in the SALVARE file is cleared and the current rollout file 
is released. A dayfile message is issued saying user recovered. 
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B. A completion logout will be done for all entries that have been there longer than 

10 minutes. At that time the files will be released and subsequent dayfile messages 
issued. 

C. If necessary, the beginning and EOI sectors for each file will be validated to see if 
the users files are all there. 

D. The status at the time the user was recovery processed is returned in VFST+4. 
(VROT+4) is returned as 0003. 

The SALVARE file is always at FNT ordinal 1. It is initialized and set busy by 1TA. If 1TA 
finds the file active or mashed up (unrecognizable at recovery time) it will hang with MXFN 
monitor function. The format for the file is: 



12 



18 



eq 



FT 



HRS 



MIN 



SEC 



UI 



eq = est ord of rollout file 

FT = first track of rollout file 

HRS. MIN. SEC = last entry time in compressed format 

UI = Usenindex 

As an example, see the following dump of the SALVARE file. TELEX was active with 20 ports 

defined in the MUX entry. Only one user was active, and there were four pseudo terminals. 

The TTY responded TTY 4 to this user at log in, and the T display showed this user at 

terminal 4. The file consists of Sector 0, the system sector, section 1, the terminal recovery 

data, and sector 2, the EOI. 

Sector 1 data is 50 words long, with two entries for each terminal which are pseudo terminals 

thru 3 and actual terminals 4 thru 23. 

The recovery information for the user at Terminal 4 is: 

eq = 

FT = 557 

time= 24.45.43 

UI = 1. 
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14.0 INTRODUCTION 

Transaction processing is handled as a distinct subsystem within the KRONOS operating 
system; therefore, all of the features available under KRONOS are retained when KRONOS 
is operating as a transaction processing system. These features include: 

• Local batch processing 

• Remote batch processing 

• Deferred batch processing 

• Interactive terminal processing (also called application program) 

Under the transaction subsystem, a user program is referred to as a task. A task is the 
absolute binary code generated from the assembly or compilation of the user program. 

These tasks read and update information on the subscriber's data base and generate output 
to the transaction terminals. User programs reside at subcontrol points within the field 
length of the transaction executive (TRANEX), which resides at control point 2. 

The subcontrol point feature allows the transaction executive to maintain complete control 
over each task. Some of the advantages associated with subcontrol points are: 

1. Isolation of one subcontrol point from other subcontrol points and the 
transaction executive, guaranteeing system security. 

2. Blocking of RA+1 requests from a subcontrol point. No PP requests or 
I/O actions are allowed directly from a subcontrol point. Any such 
requests are intercepted by the system monitor which returns control 
to the control point executive program. 

3. Freedom to move, load, and overlay areas within the subsystem field 
length. Since each subcontrol point has a relative origin of zero, absolute 
overlays all originating at a given address (for example, 100B) can be 
loaded in any order and at any place within the subsystem field length. 

The transaction executive allows a maximum of 31 10 subcontrol points. An installation 
parameter sets the number of subcontrol points that the transaction executive initializes. 
See Section 3 of the KTS Reference Manual for a complete description of the transaction 
executive. When the transaction executive is loaded, the operator may select a number of 
subcontrol points other than this default value. The number of subcontrol points must not be 
less than two or greater than 32. Once the transaction executive is initialized, no change 
in the number of subcontrol points is allowed. 
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Each subcontrol point requires eight words of table space within the transaction executive. 
No space, other than a table entry, is allocated for a subcontrol point unless it is active. 
The optimum number of subcontrol points is selected by the site. It is suggested that 6 to 
12 subcontrol points be used initially. 

The KRONOS data manager controls the structure of user data, thereby relieving the user 
of this responsibility. In order to control this data, the data manager must be supplied 
information about a user, his application area, and installation. This information is pro- 
vided by the user at data base definition time. A data base can be defined as this control 
information together with transaction data supplied by the user. 

The transaction data consists of logically related data files. Data files have specific names 
that provide a common point of reference between user programs and the data manager. 
Data files are structured into logical groups of information called records. Records may 
be subdivided into elements. One or more elements may serve as a key or identifier for a 
record. 

At data base definition time, the user supplies a description of all data elements and data 
files to be contained in the data base. Changes to the data base definition can be made by 
using the data base utility DBFORM. 

The information provided to the data manager consists of parameters that describe the 
physical allocation of the data, parameters that describe the element characteristics and 
security, and parameters that describe the file organization. 

When accessing data through the data manager, user programs require only a minimum 
amount of information concerning the data. The data manager structures the data for rapid, 
efficient retrieval. The user program need not be aware of the structure of the data it 
accesses. 

At data base definition time, the user supplies a description of all data elements and data 
files to reside in the data base. DATADEF converts this description to a file known as the 
Element Descriptor Table (EDT) for the data base. DBFORM is a utility which actually 
creates the data base according to the EDT. DBFORM can also be used later to modify 
the initial data base. When modifications are to be made, a new EDT is usually required. 

Figure 14-1 shows the relationship between the three utilities DATADEF, DBFORM, and 
DATAMAP and batch job data manager DBMI. First, the User defines the data base 
structure. DATADEF (1) creates the Element Descriptor Table (EDT). DATAMAP (2) 
reads the EDT and produces a listing. Second, the User specifies filenames. DBFORM (3) 
appends those names to the appropriate EDTs. DBFORM preallocates files on disk, thus 
creating empty permanent files. TAPE is used when reformating existing files. The 
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Figure 14-1. Data Base Creation 



Data Base Identification file (DBID) is only used by TRANEX. Third, batch job writes 
data to files using data manager commands. BDMI (4) stores data in pre-defined files 
based on the EDT specifications. 

For a more detailed description of DATADEF and DBFORM, consult the Transaction 
Subsystem Reference Manual. 

14. 1 KTSPL STRUCTURE 

The KRONOS Transaction Subsystem (KTS) is a set of routines that provide transaction 
processing capabilities. All KTS routines are available on the KTSPL. The structure 
of the KTSPL is outlined as follows: 
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• Common decks 

• PP routines 

• CP routines 

• User library routines 

• Tasks 

14. 1. 1 Common decks include the following: 

COMBACM - Access methods 

COMBACT - Add entry "CRAT" (Copy Reference Address Table) table 

COMBBCT - Build a copied record address table 

COMBDBM - KTS Data Manager 

COMBELP - CYBERLOAN element processor 

COMBINT - CYBERLOAN initialize data manager 

COMBSCT - Search a copied record address table 

COMKMAC - 'Data Manager Macro definitions 

CALLKTS - A routine similar to CALLCPU that calls COMKMAC to 

obtain an individual listing of KTS interface macros. 

14. 1. 2 There are only two PP routines associated with KTS. They are: 

CS1 - PP portion of KTS stimulator 

1TP - An auxiliary PP routine call by TRANEX (via TLX) to process various 
functions 



14. 1. 3 The CP routines include the following: 

DBFORM - Utility to create /update DBID file 

DATADEF - The 2-pass Data Definition Language (DDL) (COMPASS) compiler. 

DATAMAP - A routine that provides a concise map of a data base description 
as established by DATADEF. 

LIBTASK - The KTS utility used to build and edit a task library. 

PRESIM - Converts data to TRANSIM's input format. 

TRANSIM - Interface between user program and CS1. 

TRANEX - The KRONOS Transaction Executive. 

14. 1.4 The user library routines include FORTRAN Extended and COBOL interface 
routines and the batch user's data manager interface. These routines written in CP 
COMPASS are: 
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BDMI 

CALLTSK 

CEASE 
CMDUMP 

DMGR 

DSDUMP 
JOURNL 
SEND 
TARO 

TSIM 



The interface necessary to execute the KTS Data Manager 
from a batch job. 

FORTRAN Extended subroutine to -request scheduling of 
tasks. 

Terminate task execution. 

Dump a task's central memory, exchange package, and/or 
data manager buffers. 

KTS data manager interface routines (GETN, PUT, REPOS, 
etc. ) 

Allows a task to change any of the default CM dump options. 

Allows a task to write entries on the JOURNAL file. 

Enables a task to send a message to a terminal. 

Enables a task to alter the "user argument" area within a 
terminal table entry. 

Allows a task to get terminal status and information. 



14. 1. 5 There are four tasks provided on the KTSPL. They can be modified and then 
stored on a task library permanent file under the user number and password assigned to 
the Transaction Subsystem. The four tasks are: 



ITASK 

KDIS 

MSABT 
OFFTASK 



An initial task used to interface between TRANEX and other 
user application tasks. It processes all transaction input to 
determine which user task to call. ITASK is provided to 
serve as an example and will vary for each installation. 

The TRANEX K-display command directory. KDIS is a 
task initiated by the operator by typing K. SWITCH. The 
purpose of the task is to save core in TRANEX. 

A system task which sends error messages to the originating 
terminal when a transaction ends abnormally. 

A task scheduled by TRANEX when a request is made for an 
inactive task (i. e. , a task in the task library but has been 
turned off either by LIBTASK directive or operator command). 
OFFTASK simply sends a message to the originating terminal 
informing it that an inactive task was requested. 



14. 1. 6 Figure 14-2 is two pages from a KRONREF run using the KTSPL. Only the cross 
reference of the common decks called is shown. The cross reference of symbols used is 
not shown since there are very few references with only two PP routines. 

14.2 TRANEX 

The relationship between TRANEX and TELEX is shown in Figure 14-3. Notice that the 
Time-Sharing Executive (TELEX) runs at control point 1, while the Transaction Executive 
(TRANEX) runs at control point 2. This is done to avoid a storage move of the two 
executives which would be necessary if they resided at other control points. Transactions 
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DECK 


DECK REFERENCES. 














COMBACM 


DBFORM 


TRANEX 


BDMI 












COMRACT 


DBFORM 


TRANEX 


BDMI 












COMBBCT 


DBFOUM 


TRANEX 


BDMI 












COM BDBM 


TRANEX 


BDMI 














COM BE LP 


DBFORM 


TRANEX 


BDMI 












COM BINT 


TRANEX 


BDMI 














COMBSCT 


DBFORM 


TRANEX 


BDMI 












COMCARG 


DATADEF 


DATAMAP 


DBFORM 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 




COMCCDD 


DATADEF 


DATAMAP 


DBFORM 


KTSDMP 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 


COMCCFD 


DATADEF 


TRANEX 














COMCCIO 


DATADEF 


DATAMAP 


DBFORM 


KTSDMP 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 


COMCCOD 


DATADEF 


KTSDMP 


PRESIM 


TRANEX 


BDMI 








COMCCPM 


DBFORM 


KTSDMP 


LIBTASK 


TRANEX 


TRANSIM 


BDMI 






COMCDXB 


DATADEF 


DBFORM 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 


BDMI 




COMCEDT 


TRANSIM 
















COMCLFM 


DBFORM 


PRESIM 


TRANEX 


TRANSIM 










COMCMAC 


DATADEF 


DATAMAP 


DBFORM 


KTSDMP 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 


COMCMTM 


DATADEF 


DATAMAP 


DBFORM 


LIBTASK 










COMCMTP 


DATADEF 


DATAMAP 


DBFORM 


LIBTASK 










COMCMVE 


DATADEF 


DATAMAP 


DBFORM 


LIBTASK 


TRANEX 


BDMI 






COMCOVL 


TRANEX 
















COMCPFM 


DBFORM 


KTSDMP 


LIBTASK 


TRANEX 


BDMI 








COM CROC 


DBFORM 


PRESIM 


TRANEX 


TRANSIM 










COMCRDO 


DATADEF 


DATAMAP 


DBFORM 












COMCRDS 


DATADEF 


DBFORM 


LIBTASK 


PRESIM 


TRANEX 








COMCROW 


DATADEF 


DATAMAP 


DBFORM 


KTSDMP 


LIBTASK 


PRESIM 


TRANEX 


TRANSIM 


COMCRTN 


PRES1M 


TRANEX 














COMCSFM 


TRANEX 

















BDMI 



BDMI 



BDMI 



BDMI 



CD 

O 
-J 

o 
o 

Eft- 



Figure 14-2. KRONltEF Run 
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Figure 14-3. TRANEX -TELEX Relationship 



are passed between TRANEX and TELEX via inter-control point communication. That is, 
the CPUMTR function, SIC, is used to transfer data between control points. 

Figure 14-4 shows the breakdown of the TRANEX control point. The data manager code is 
contained in common deck COMBDBM and is called by TRANEX and by BDMI for batch 
| processing. TRANEX will support up to 31 subcontrol points. 

Since time does not allow for a detailed level of documentation for the entire subsystem and 
associated utilities, only the following routines will be discussed. 

• TRANEX - Control Point Initialization and Termination 

• TRANEX 1 - Executive Initialization 

• TRANEX — Run Time Executive 

• TRANEX2 - Recovery/ End Processor 
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14. 3 TRANEX - CONTROL POINT INITIALIZATION AND TERMINATION 

TRANEX is initialized similar to TELEX. That is, 1TP is called by IDS when the 
operator types: TRANEX. 1TP initializes the TRANEX control point by performing the 
following functions: 

Checks error flag 

Sets jobname "TRANEX" in control point area 

Sets CPU priority to 76 

Requests 50, 000B words of CM 

Writes the control card buffer 

The control card buffer contains the following: 

TRANEX1. 
TRANEX2. 
EXIT. 
TRANEX 2. 

When 1TP is dropped, 1AJ processes the next control card, TRANEX 1, thus loading the 
CP initialization code for the TRANEX subsystem. TRANEX 1 is absolute and loads at 
RA + 101B. TRANEX1, after performing initialization, loads the runtime program, 
TRANEX. The control card TRANEX2 will be processed whenever TRANEX is stopped 
by the operator or when an abnormal condition is detected by TRANEX. If TRANEX2 
finds no errors and RECOVERY was selected (operator selected sense switch 4, ONSW4, 
at TRANEX control point), TRANEX2 restarts the subsystem by calling 1TP to perform 
initialization. (1TP is called via the TLX monitor function. ) If the operator selected 
sense switch 5, ONSW5, TRANEX2 calls DMP to dump the TRANEX field length and then 
calls OUT (uses RELEASE macro, which calls LFM) to print the dump. In this case, 
if sense switch 4 (ONSW4) is also selected, restart is initiated as above. When looking 
at the dump, remember that TRANEX2 code was originated (ORG) at the K-display proc- 
essing code (KDIS), and this portion of TRANEX is wiped out by TRANEX2; since both 
use the same memory area, similar to TELEX and TELEX1. 

14.4 TRANEX1 -TRANSACTION EXECUTIVE INITIALIZATION 

TRANEX1 is loaded by 1AJ in response to the control card call set up by 1TP. As an 
initialization routine, it builds tables, allocates buffers for TRANEX and the data manager, 
and attaches files for TRANEX and the data manager. TRANEX1 drives the K-Display 
to allow the operator to change default initialization parameters. These parameters are 
explained in the Transaction Subsystem Reference Manual. As mentioned previously, 
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when TRANEX1 completes initialization, the run time executive is loaded via the loader 
initiated from the OVERLAY macro in TRANEX1. Subroutines, FET, buffers, and 
common decks from TRANEX1 follow, in the order of their occurrence in the source. 

RA+10B - Pointers (set by TRANEX1) 

RA+101B EMIT code 

FETS - RECOVERY file, JOURNAL FILE FET, and Data Manager 
Input/Output FET 

SETL - Set table locations and lengths (attach JOURNAL FILE O) 

IDM - Initialize Data Manager (DM) 

ABJ - Allocate buffers for JOURNAL files (other than 0) 

LTL — Load task library directories 

ATT - Attach POOL, TRACE and JOURNAL files 

■ XXJ — Initialize journal files for data base XX, 

ICRT - Initialize Copied Record Address Table (CRAT) 

ANT - Attach NETWORK DESCRIPTOR file 

DIE — Process DM Error Messages 

Messages — DM Error Messages 

SDT - Set Data Base Table 

Initialization Parameters 

FET for DBID file 

Error Messages for SETL 

FET for task library file 

Common Decks including: 

COMBINT - Initialize Data Manager 

Circular Buffers 

SETK - K-Display Initialization 

K-Display Command Processors 

K. SCP = N 

K. CMB = N 

K. CRS = Terminal Name 

K. REC = AA 

K.MFL 
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K. TLF = Task library file name 

K. MDM = N 

K. DB1 = AA 
K- Display Subroutines 
Common Decks 



The character "V" as the first character of a symbolic name is used to indicate a table or 
buffer pointer. The values are initialized by TRANEX1 and used throughout TRANEX via 
the opdef'calls. The TRANEX preset code (PRE) actually performs the instruction modi- 
fication for the table addresses. In other words, the variable length tables are assigned 
addresses during initialization (TRANEX1) and referred to thereafter with 30-bit increment 
instructions without the need of picking up a pointer (TRANEX). The names and locations 
of the pointers are listed in Table 14-1. 

TABLE 14-1. TABLE AND BUFFER POINTERS 



Word 



10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 

26-31 

32 
33 
34 
35 



Name 



VNSCP 

VNCMB 

VSTS 

VNTST 

VMDM 

VLSP 

VATL 

VFSCP 

VCBRT 

VCBSA 

VTLD 

VEDT 

VPOTT 

VMFL 

VSDB 

VTFL 
VREC 
VCRAT 
VCRS 



Meaning 



Number of subcontrol points 

Number of communication blocks 

FWA of terminal status table 

Number of entries in terminal status table 

Multiple for DM buffers 

Address of last subcontrol point 

Address of Active Transaction List (ATL) 

FWA of sub-CP allocatable storage 

CB (Communication Block) storage allocation bit maps 

Start of communication blocks 

Start of task library directories 

Base address of descriptor tables 

Start of buffer area for Data Manager 

Maximum FL for subcontrol points, 40K< 
VMFL < 300K (different than K. MFL) 

Data Base Names specified by operator (used instead of 
DBID) 50 -»240K. 

Task library file name 

Recovery flag 

FWA of Copied Record Address Table (CRAT) 

CRAS terminal name 



TA 



(x) 



opdef used in the following manner: 



TA1 variable name ex: VSTS is expanded as SA1 VSTS 

SA1 x 1 + proper offset to table. But not modified as two instructions but as 

one by PRE as: SA1 (VSTS) + proper offset to table. 
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The flowchart shown in Figure 14-5 outlines the routine ESTT which performs the initiali- 
zation for the executive and for the data manager. The flowchart shows an overview of the 
Transaction Executive initialization process. The tables and buffers are set up in sub- 
routine SETL. Following the flowchart, Figure 14-6 provides an overview of TRANEX 
memory, showing the order of the tables and buffers established during initialization. 
Subsequent discussion explains each table and buffer. 
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Figure 14-5. IN IT Flowchart 
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TRANEX 


LAST+1 
VCBRT 


Data Manager 


Sub Control Point 
Table 


VCBSA 
VATL 

VSTS 


Bit maps for(CB) 
Communication Blocks 


Communication 
Blocks 


Active 

Transaction 

List 


Terminal Status 
Table 


VEDT 


EDT 
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CRAT 
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VPOTT 
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Data Manager 
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Sub- Control 
Points 
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(one word per C. B. Each 
entry points to a C. B.) 
Built from NETWORK file or 
SIMFILE. Entries sorted 
on MUX channel, equip, port 
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ERPF Error Recovery Pool File 

Pointed to by FET's in EDT 
above. 2002B words for MT, 
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Space allocated by TRANEX1, 
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Figure 14-6. Buffers and Tables of TRANEX 



14. 4. 1 Sub- Control Point Table 

The structure of the sub-control point table as established by SETL is shown in Figure 14-7. 
LAST+1 



CPAL=10B 
CPAL=10B 
CPAL=10B 



VLSP 



VCBRT 



FL=0 RA1 



FL=0 RA2 



FL=0 RA3 



FL=0 RAn 



D 



} 



Figure 14-7. Sub-Control Point Table 
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flags 


FC 


FL 


RA 


flags 


NC 


EP 


CC 


NM 


TS 


LS 


NS 


flags 




CBA 



RA is relative to TRANEXl's RA. The format of the sub-control point table entry is shown 
in Figure 14-8. 

(Status Words \ 
Word 1 

Word 2 

Word 3 

WordN 

Figure 14-8. Sub-Control Point Table Entry Format 

14.4. 1. 1 Status Word 1 

Flags - bit Meaning 

59 if set, the S. C. cannot be moved 

58 if set, this S. C. can be released if storage 

needed 

FC — Available free core after sub- control point 

FL - Sub CP field length 

RA - Sub CP reference address (relative to TRANEX RA) 



14.4. 1.2 Status Word 2 

Flags - bit Meaning 

59 flags a system task which gets entire 

comm. block 

58 if set, task code is reusable 

57 if set, task is CM resident 

56 recall status bit 

55 not used 

54 if set, task is to be aborted 

NC — Number of communication blocks at sub C. P. 

EP — Entry point address 

CC — Address of status word for C. B. now in execution 

14.4. 1. 3 Status Word 3 

NM — Task directory index 
TS - Time slice limit 
LS — Last sub- control point 
NS — Next sub- control point 
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14. 4. 1. 4 Status Words N 

Flags - bit Meaning 

59 set if communication block is present at sub C. P. 

54 set if initial comm. block 

CBA - FWA of Communication Block 

The length of the sub-control point entry is 10B words. Thus, there are 5 words of type N. 
The length of an entry is defined by CPAL and must be a multiple of 10B (i. e. , 10B, 20B, 30B, 
etc. ). 

14. 4. 2 Communication Blocks 

Communication blocks are set up by SETL merely by reserving CMBL* NCMB words. 
CMBL is the length of one entry and is equal to 69+5 = 74 (a 5-word system header and 
69 words of data). NCMB is the number of communications blocks (4 by default). Although 
not written during initialization, the format of the 5-word system header is shown in 
Figure 14-9. 

COMMUNICATIONS BLOCK SYSTEM HEADER 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 

Wl 

W2 

W3 

W4 

W5 

WORD 1 

CP - CPU PRIORITY 

D - ALLOWED TO MAKE DBA REQUESTS 

R - RECALL ON ALL OUTSTANDING D. M. REQUESTS 

M - AT LEAST ONE MESSAGE WAS SENT TO TERMINAL 

A - TRANSACTION CHAIN HAS ABORTED 

SEQ - PRIMARY SEQUENCE COMMUNICATIONS BLOCK 

ADDRESS 

DRC - DBA REQUESTS CURRENTLY OUTSTANDING 



Figure 14-9. Communications Block System Header 



/ CP /DRMA / SEQ 






/ 


DRC / 


/ TSO 


/RS/US/ 


TST 




/ 


CBA / 


/ IT / 


2T / 


3T 


/ 


4T 


/ 5T / 


/ABC / 


LWA 


/ 




/ 


FWA / 


/ QD 








/ 


/OT / QI / 
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WORD 2 

TOO 

RS 

ws 

TST 
CBA 

WORD 3 
IT 

2T 
3T 
4T 
5T 

WORD 4 
A 

B 
C 

LWA 
FWA 

WORD 5 
QD 
OT 
QI 



lj-j wivj-'jj.-in.ij 



TERMINAL DATA BASE READ SECURITY LEVEL 
TERMINAL DATA BASE WRITE SECURITY LEVEL 
ADDRESS IN TST FOR TERMINAL 
COMMUNICATIONS BLOCK ADDRESS 



NEXT TASK SCHEDULE 
2ND TASK EST CHAIN TO SCHEDULE 
3RD TASK IN CHAIN TO SCHEDULE 
4TH TASK IN CHAIN TO SCHEDULE 
5TH TASK IN CHAIN TO SCHEDULE 



VALID DSDUMP REQUEST (A=l) 
DUMP EXCHANGE PACKAGE (B=l> 
DUMP DATA BASE BUFFERS (C=l) 
LAST WORD ADDRESS OF TASK DUMP 
FIRST WORD ADDRESS OF 



1 ASK. uumi^ 



QUEUE DESIGNATOR (SEE K. DSDUMP) 
ORIGIN TYPE VALUE OF QUEUE DESTINATION 
QUEUE DESTINATION INDICATOR 



Figure 14-9. Communications Block System Header (Continued) 

« 
14. 4. 3 Active Transaction List 

The Active Transaction List (ATL) as established by SETL contains a 1-word entry for 
each communication block. Each ATL entry contains a pointer to a communication block. 
The format of the ATL entry is shown in Figure 14-10. 

ATL ACTIVE TRANSACTION LIST 

5 4 3 2 1 

987654321098755432109876543210987654321098765432109876543210 



NT 



PT 



CBA 



NT NEXT TASK IN QUEUE CHAIN (BIASED BY +1) 

PT PREVIOUS TASK IN QUEUE CHAIN (BIASED BY +1) 

CBA ADDRESS OF COMMUNICATIONS BLOCK 



Figure 14-10. Active Transaction List 
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14.4.4 Terminal Status Table 

The Terminal Status Table (TST) contains a 2-word entry for each terminal described in 
the NETWORK file or SIMFILE (Diagnostic). The list of entries is sorted according to 
multiplexer channel, equipment, and port key. For a description of the NETWORK file, 
consult Part IV, Section 3 of the Installation Handbook. The format of the TST entry is 
shown in Figure 14-11. 

TST TERMINAL STATUS TABLE 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



Wl 


/ DO CH/EQ/PT /RS/US/ 


DB 


/ 


UA 




/ 


W2 


/ TN 






/ 


NT 


/ 



WORD 1 

D - TERMINAL DOWN 

O - TERMINAL ON /OFF 

CH - MULTIPLEXOR CHANNEL 

EQ - MULTIPLEXOR EQUIPMENT 

PT - MULTIPLEXOR PORT 

RS - DATA BASE READ SECURITY LEVEL 

US - DATA BASE UPDATE SECURITY LEVEL 

DB - DATA BASE TERMINAL IS VALIDATED TO USE 

UA - USER AREA 

WORD 2 

TN - TERMINAL NAME 

NT - NUMBER OF TRANSACTIONS RECEIVED FROM TERMINAL 



Figure 14-11. Terminal Status Table 

After SETL completes the initialization of the tables mentioned previously, routine IDM 
is initiated to initialize the data manager using the remaining field length. IDM attaches 
the data base identification file (DBID). The contents of the file are read into core (error if 
not enough core) and written to the RECOVERY file. The entries in the file contain data 
base names for the EDT files which must be attached. However, before proceeding, sub- 
routine SDT is executed to allow the operator (via the K-display) to specify up to three 
data base names. Specifying certain names negates the use of DBID. The main loop for 
data manager initialization starts at location EDM3 and continues through IDM4 and IDM5. 
The procedure is outlined in the following steps: 

1. Attach XXJ file for this data base. This file provides the user's account 
number and password which are stored in the EDT header. 
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2. Call subroutine INT in common deck COMBINT. This routine attaches the 
journal files described in the XXJ file attached in step 1. Trace and pool files 
(XXTFIL and XXERPF) are assigned FET's. The 5-word EDT header is 
initialized followed by the EDT entries for this data base as specified in file 
XX (XX=two character data base name). (The EDT header is described later. ) 

3. A call to subroutine ATT attaches the pool and trace files (XXERPF and XXTFIL). 

4. Call XXJ again. XXJ will establish FET's for the journal files (maximum of 3), 
call ATT to attach them, and update EDT header word 2 and 3. 

The preceding processing continues for all known data bases. Next, the Copied Record 
Address Table (CRAT) is initialized by subroutine ICRT. The subroutine reads the Error 
Recovery Pool Files (XXERPF) for the various data bases. Any records found in these 
files are placed into the CRAT. The CRAT is defined to be CRATL words long (currently 
CRATL=100B). If more records exist than what will fit into the 100B word table, TRANEX1 
aborts. 

After initializing the CRAT, IDM calls subroutine ABJ to allocate circular buffers for 
journal files. Tape and disk buffer sizes are defined by symbols TAPL and DSKL, 
respectively. 

Currently, TAPL = 2002B, and DSKL = 402B. 

Next, the last subroutine, LTL, is called. This subroutine loads the system task library 
directory, TASKLIB, and XXTASKL (XX=data base), the directory for each data base. 
These directories have been created by subsystem utility, LIBTASK, and occupy the last 
record of the task library. Reference the KRONOS 2. 1 Reference Manual for the format of 
the directory. 

Finally, IDM determines the amount of buffer space required based on the number of sub- 
control points, and sets the starting address for the sub-control points. Control returns 
to INIT5+1 which flushes the recovery file and loads the main program, TRANEX. The 
loader performs the loading of TRANEX and begins execution at the preset routine PRE. 

Figures 14-13 and 14-14 contain tables set up by INT for data manager initialization. 
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14.4. 5 EDT Structure 

The EDT format is shown in Figure 14-12. 



EDT 
sfy Entries 



EDT 
Header 




LINK 



# 



EDT 
Header 




LINK 



EDT 



1/ jcjji y 

Y Entries T 



for data base XX 



for data base yy 



Figure 14-12. EDT Format 

Figure 14-13 describes the format of the EDT header and the EDT entry. (The EDT entry 
is the EDT entry created by DATADEF). 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



VEDT1 


/ 


DB 


/ 


/EDTCNT 


/ LINK 


/ 


VEDT2 


/JORCN/ 


/JORADP 


/TRCADR 


/ 


VEDT3 


/ 




USERNM 




/USINDX 


/ 


VEDT4 


/ 




PASSWD 




/ 


/ 


VEDT5 


/ 




/TLDFWA 


/ 


/TLDLWA / 





WORD 1 

DB - DATA BASE NAME 

EDTCNT - NUMBER OF EDTS (PRESENT ONLY IN FIRST HEADER) 

LINK - POINTER TO NEXT EDT 

Figure 14-13. EDT Header and Entries 
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WORD 2 

JORCN 
JORADR 
„TRCADR 

WORD 3 

USERNM 
USINDX 



NUMBER OF JOURNAL FILES (MAXIMUM OF 3 PER DB) 
ADDRESS OF FIRST JOURNAL FILE FET 
ADDRESS OF TRACE FILE FET 



USER NUMBER (USED TO ATTACH MULTIPLE TLDS) 
USER INDEX (TO ATTACH POOL, JOURNAL, TRACE, DB, 
AND DATA BASE FILES) 



WORD 4 

PASS WD 

WORD 5 

TLDFWA ■ 
TLDLWA ■ 



- PASSWORD 

FWA OF DBTASKL (NAME OF PARTICULAR TLD) 

LWA OF DBTASKL 



DES1 
DES2 

FNT1 
FNT2 
FNT3 
FNT4 

ELE 



GLT 
STL1 
STL2 
STL3 



EDT ELEMENT DESCRIPTOR TABLE 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



/ DB NAME 



/ EDT LENGTH / NUMBER OF FILES / 



/ ADDR GROUP LIST / ADDR SEARCH TABL/ ADDR FNT 



/ FILENAME 



AM BIAS 



/ AM / /TD TYPE/ 
/ RS/ US/ LENGTH ELST/ ADDR ELIST / 



/ FWA FET / NUMBER OF RECORDS / RECORD SIZE / 

/ CHAIN KEY / PTRS ORD /ORD PTR FNT/ FILE LOCK I. D. / 

/ EOI /AP/LN / IN /P/LN / IN / 

/NAME /TY/FM/ FB /RS/US/ LENGTH / WRD ORD / 

/NAME /TY/FM/ OPEN/RS/US /LENGTH /LORD / 

/NAME /TY/FM/ FB /RS/US/ LENGTH / SER ORD / 



/ EL ORD /ED ORD /EL ORD 
/ PIO / DFO / OPEN 



/EL ORD / EL ORD / 

/ WRD ORD / KTY/ 



/ PKSO SDF / PKSO PDF / SDFOE / 
/ SDFIO / SDFO / OPEN 



/ WRD ORD / KTY/ 
/ WRD ORD / KTY/' 



Figure 14-13. EDT Header and Entries (Continued) 
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-DES1- 



DB NAME 
EDT LENGTH 

NUMBER OF FILES 



DATA BASE NAME. 

LENGTH OF ELEMENT DESCRIPTOR TABLE IN 

CENTRAL MEMORY WORDS. 

NUMBER OF FILES IN THIS DATA BASE. 



-DES2- 

ADDR GROUP LIST 
ADDR SEARCH TABL 
ADDR FNT 



RELATIVE ADDRESS OF GROUP LIST TABLE. 
RELATIVE ADDRESS OF SEARCH TABLE. 
RELATIVE FWA OF FILE NAME TABLE. 



-FNTl- 

A M 
T 
D 
TYPE 



ACCESS METHOD ORDINAL. 
TRACE BIT. 
DUAL RECORD BIT. 
FILE TYPE. 



-FNT2- 

A M BIAS 

RS 

US 

LENGTH ELST 

ADDR ELIST 



BIAS VALUE FOR ACCESS METHOD. 
READ SECURITY OF RECORDS IN FILE 
UPDATE SECURITY OF RECORDS IN FILE 
LENGTH OF ELEMENT LIST IN CENTRAL 
MEMORY WORDS. 
RELATIVE ADDRESS OF ELEMENT LIST. 



-FNT3- 

FWA FET 

NUMBER OF RECORDS 

RECORD SIZE 



ABSOLUTE ADDRESS OF FET FOR THIS FILE. 

NUMBER OF RECORDS IN A PRE-ALLOCATED 

FILE. 

RECORD SIZE IN CENTRAL MEMORY WORDS. 



-FNT4- 
CHAEN KEY 



PTRS ORD 



ORD PTR FNT 



ORDINAL OF ELEMENT IN THE CHAINED FILE 
WHICH IS THE KEY TO THE OWNER FILE. THIS 
KEY IS THE COMMON LINK OF ALL RECORDS 
IN THE CHAIN. 

ORDINAL OF ELEMENT IN THE OWNER FILE 
WHICH CONTAINS THE KEYS TO THE FIRST 
AND LAST RECORDS OF THE CHAIN. 
RELATIVE ADDRESS OF THE FILE NAME TABLE 
ENTRY OF THE OWNER FILE. 



-FNT5- 

EOI 

A 

P 

EN 

LN 

S 

IN 

LN 



CURRENT EOIOF FILE. 

ADD/PURGE/RECHAIN EN PROGRESS. 

FILE HAS AT LEAST ONE POOLED RECORD. 

INDEX FOR FILES *CRAT* ENTRIES. 

NUMBER OF POOLED RECORDS. 

SECONDARY FILE (IF DUAL RECORDED) HAS 

AT LEAST ONE POOLED RECORD. 

INDEX FOR SECONDARY FILES *CRAT* ENTRIES. 

NUMBER OF POOLED RECORDS. 



Figure 14-13. EDT Header and Entries (Continued) 
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-ELE- 



NAME 

TY 

FM 

FB 

RS 

US 

LENGTH 

WRDORD 

L ORD 

SERORD 



■«■ *■■*■■*-* i 1 1 i i~-h.j?% .Litf^v^ j. £* xv p " ■ i- ' '"^ j?f i" i. i> n iviji* * 

TYPE OF ELEMENT. 

FORM OF ELEMENT. 

FIRST BIT (INDICATES POSITION WITHIN WORD). 

READ SECURITY CODE. 

UPDATE SECURITY CODE. 

LENGTH OF ELEMENT IN BITS. 

RELATIVE ADDRESS OF ELEMENT IN DATA FILE. 

RELATIVE ADDRESS OF GROUP LIST TABLE? * 

RELATIVE ADDRESS OF SEARCH TABLE. 



EL ORD 

-STL1- 
PIO 

DFO 

K TY 

-STL2- 
PKSO 3DF 

PKSO PDF 

SDFOE 



-STL3- 
SDFIO 



SDFO 



RELATIVE ADDRESS OF ELEMENT TABLE 
ENTRY FOR THIS SUB-ELEMENT OF THE GROUP. 



RELATIVE ADDRESS OF FNT ENTRY FOR THE 

PRIMARY INDEX FILE. THIS FIELD IS SET ONLY 

IF DFO IS AN INDEXED FILE. 

RELATIVE ADDRESS OF FNT ENTRY FOR THE 

PRIMARY DATA FILE. 

KEY TYPE. 



RELATIVE ADDRESS OF SEARCH TABLE ENTRY 

WHICH CONTAINS THE PRIMARY KEY INFO FOR 

THE SECONDARY DATA FILE. 

RELATIVE ADDRESS OF SEARCH TABLE ENTRY 

WHICH CONTAINS THE PRIMARY KEY INFO FOR 

THE PRIMARY DATA FILE. 

RELATIVE ADDRESS OF THE ELEMENT IN THE 

SECONDARY DATA FILE WHICH IS THE PRIMARY 

KEY TO THE PRIMARY DATA FILE. 



RELATIVE ADDRESS OF THE FNT ENTRY FOR THE 

PRIMARY INDEX TO THE SECONDARY DATA FILE. 

THIS FIELD IS SET ONLY IF SDFO IS AN INDEXED 

FILE. 

RELATIVE ADDRESS OF FNT ENTRY FOR THE 

SECONDARY DATA FILE. 



Figure 14-13. EDT Header and Entries (Continued) 

14. 4. 6 Task Library Directory 

The task library directory header is shown in Figure 14-14. 



97404700A 



14-23 



VTLD-4 
VTLD-3 
VTLD-2 
VTLD-1 



5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



/ 


/ 


TLDS / 


/ 


TLDL 


/ 


/TLD 


/ 


/ BOOT 


/ 


NUMC 


/ 


/ 


DATE 








/ 


/ 


NAME 








/ 



VTLD-4 


TLDS 
TLDL 


VTLD-3 


TLD 




BOOT 
NUMC 


VTLD-2 


DATE 


VTLD- 1 





SIZE OF ALL TLDS COMBINED 
LENGTH OF CURRENT TLD 

3 CHARACTERS USED TO VERIFY HEADER AS 

TLD TYPE 

NUMBER OF ENTRIES IN DIRECTORY BOOT 

NUMBER OF CORE RESIDENT TASKS 



- YY/MM/DD. 
NAME - NAME OF TLD FILE. 



Figure 14-14. Task Library Directory 

14. 5 TRANEX - Run Time Transaction Executive 

TRANEX is loaded at RA+101B by the loader which begins execution at the preset routine, 
PRE. In general, PRE completes the initialization started by TRANEX1. This preset 
routine functions in the following sequence of steps. 

1. Call subroutine SETA to modify the 30-bit increment instructions used through- 
out TRANEX binaries. This eliminates the need for reading up pointer words 
(V-words) when referencing tables. 

2. Call PW to set variable values, such as maximum field length (MFL), current 
field length (CURFL), and available central memory allocatable within TRANEX 
(AVAILCM). 

3. Call PCR to set the CRAS terminal ordinal in CSMC for routines which send 
messages to the CRAS terminal. 

4. Call LIT to load the initial task from system task library to sub- control point 
one. Initial task remains at sub-control point one as long as TRANEX runs. 

5. Call LCT to read task library directories and load CM-resident tasks at sub- 
control points. If more tasks than sub- control points available, abort. 

6. Call IJF to position each journal file to EOI and write a lable containing the 
current date. 

7. Read date and time and real-time clock. Clear message line 2, and send 

version number to console. 
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8, Call SIC to initialise inter- control point transfers. 

9. Jump to TMDC to begin main processing. 

A memory map of TRANEX is showin in Figure 14-15. Notice that three SEG pseudo 
instructions are used in the assembly of TRANEX, Their purpose is to allow COMPASS 
to write partial binaries during assembly. Thus, less core is required by COMPASS to 
perform the assembly. This is done since the four blocks are quite large. The first 
block is. about 4500 cards, the second is about 2900 cards, the third is about 7500 cards, 
and the fourth is about 1500 cards. 

The symbol TRPL is defined at the end of subroutine TRI and is rounded up to the nearest 
100B. The core from this point to the end (RA+FL is shown in Figure 14-6) is written to 

a rollout file by subroutine TRO when transaction activity stops. 

14. 5. 1 Subroutine TRI will read the file, thus rolling the field length back into the TRANEX 
control point. This occurs when transaction input is received by subroutine PRIN or when 
the rollout time slice (TROTL) has elapsed (to ensure time-originated tasks are activated). 
Currently, TRFL=600B which is the TRANEX "idle" field length. 

Location ENDT marks the end of the TRANEX run time code and the beginning of the fixed 
length buffers. Location LAST marks the end of the buffers and the beginning of the tables 
and buffers set up by TRANEX1. The fixed length buffers and their sizes are listed in 
Table 14-2. 





TABLE 14-2. BUFFERS AND LENGTH 


Buffer. 


Length 


JBUFO 


- Journal File 


1201B 


DEBF 


- D. M. Input FET 


10B 


DOBF 


- D. M. Output FET 


3 0B 


OBUF 


- Output Buffer 


401B 


SBUF 


- Scratch Buffer 


100B 



Time Dependent Routine Control consists of one routine named TMDC. TMDC calculates 
elapsed time for various subroutine calls. If the time limit for a particular routine has 
been exceeded, that routine is called. Subroutines called by TMDC include: 

PRIN — Process transaction input 
SCHD - Schedule tasks 
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written 
to roll- 
out file { 

when 
TRAKEX 
is in- 
active 



KD1S 



DISK 



ENDT- 
LAST„ 

LAST+1 



Buffers and Pointers 



Time Dependent Routine Control 



Process Transaction Input 



Rollout Routine 



TRO 



Rollin Routine 



TRI 



Routine to check and activate subcontrol points 

for time slice 



Task Scheduler 



RA+1 Request Processors 



Miscellaneous Subroutines 



CM Request Processors 



Journal File Processing 



Error Processing 



Update K-Display 



Tables: RTL and CCC 



Common Decks (COMCxxx) 



Process Task Dump 



COMBDBM KTS Data Manager 



COMBELP 
COMBACT 
COMBSCT 
COMBACM 



Fixed Length Buffers 



Start of Tables 



Block 1st 



-SEG 



if TRANEX \ Block 

dumped, this f 2nd 
is wiped out 
by DMP 



SEG 

Block 3rd 
■SEG 

Block 4th 



Figure 14-15. TRANEX Memory Map 



DM requests are queued up and several issued at one time. These are the DIBF and DOBF 
queues which are like ITD queues, i.e. circular stacks. See figure 13-9 
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DCPT - Drop CPU for a task 

KDIS — Update K- display 

CORU — Check core usage 

TRNA — Check transaction activity 

JSTS — Write statistics to journal file 

TSSC — Activate sub- control points 

The Data Manager (DM) is called by subroutine TSSC only. The data manager returns 
control to TSSC at a location defined by symbol TSSCO. The batch data manager interface 
routine, BDMI, also adheres to this convention. 

14. 5. 2 Again, referring to Figure 14-15, the RA+1 request processors include the 
following routines: 

SCT — Schedule task 

DBA — Data base access (build queue entry) 

CTI - Call TRANEX interface 

TIM — Request system time 

MSG — Place message on line one 

These routines process RA+1 requests from tasks executing at sub-control points. The 
general format of an RA+1 request is as follows: 



59 



42 41 36 35 



NAME 



R 



ARGUMENTS 



18 6 36 

RA+1 request processing begins in subroutine TSSC at tag SRTN2. The RA+1 request is 
validated. NAME is equal to one of the five subroutine names mentioned above. R=20B if 
recall is desired. R is meaningful on DBA requests only, since all other requests are 
answered immediately by TRANEX. 

14. 5. 3 The formats of the RA+1 requests for the particular routines are described 
subsequently. 



14. 5. 3. 1 SCT - Schedule a Task 

59 42 41 36 35 



18 17 



SCT 





FNC 


ADDR 
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where: 

FNC = Schedule function code (0-3) 

ADDR = Parameter address (format not given) 

FNC 



Schedule Type 

Task CEASE - end current task 

NEWT RAN - start a new transaction 

Call task with CEASE 

Call task without CEASE - start an asynchronous task 
chain 



14. 5. 3. 2 DBA - Data Base Access 



59 



41 35 



18 17 



DBA 


R 


FNC 


ADDR 



where: 
ADDR = FWA of data manager parameter area 
FNC = Data manager function code 

0-177: are handled by D. M. without special processing. 

200+ : are handled with recall. 



14. 5. 3. 3 CTI - Call TRANEX Interface 



59 



41 35 



18 17 



CTI 


R 


FNC 


ADDR 



wherei 
ADDR = FWA of parameter list 
FNC - Function code (0-10) 

= Send message to transaction terminal 

1 = Make a journal file entry 

2 = Check for a specific task chain still active 

3 = Process terminal argument operation 

4 = CMDUMP request 

5 = DSDUMP request 

6 = Return terminal status 

7 = CRAS terminal K- display command 
10 = Use task data field for K- display 
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Following is the format of the parameter list specified by ADDR for the functions of CTI. 
FNC = Send Terminal Output 

59 48 47 30 29 18 17 

ADDR ~ 

ADDR+1 

where; 



| flags 


MSG 




NUM 


| Terminal Name 







flags - bit 



meaning 



59 If set, send message to terminal specified in ADDR+1 else 

send to originating terminal. 

58 CEASE task after sending message. 

MSG - FWA of message 

NUM - number of words in message (1-100B) 



FNC -1 



Task Journal Request 
59 52 36 35 



18 17 



ADDR 



JN 



NUM 



MSG 



6 



18 



18 



18 



where? 



MSG - FWA of block to be journaled 

NUM - Number of words to write to journal file (max. = 2500D) 

JN — Journal file number 



FNC -2 



Check for Task Chain in System 



59 



42 41 



18 17 



SEQ 



STAT 



18 



24 



18 



where: 

SEQ — Sequence number of transaction 

STAT - Address of reply word. Reply word is set to zero if transaction is 
not in system. 
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The sequence number (SEQ) would be the number returned by TRANEX when the task 
issued a call to SCT function 1 (NEWTRAN). 



FNC -3 



Terminal Argument Operation 



A DDR 
ADDR+1 



Terminal Name 


Return Address 


Value 


Mask 



where: 

Terminal name — terminal to be operated upon. If zero, originating terminal 
is assumed. 

Return Address — Location in which to place result of operation (in addition to 
terminal table). Zero if no return desired. 

Value — A value to be used to alter terminal arguments. 

Mask— A 24-bit mask. 

The USER ARGUMENT area (24 bits in each terminal table entry) is operated upon as 
follows : 

RETURN=USER ARG=(USER ARG. AND. MASK). XOR. VALUE 

Non-system tasks may only alter terminal arguments for those terminals that share the 
originating terminal data base. 

FNC 4 CMDUMP 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



ADDR 


/EDAB 


/ 


LWA 


/ 


/ FWA 


/ 


ADDR+1 


/ QD 








/ OT 


/ 


ADDR+2 


/ AD 




/ 




/ NF 


/ 


ADDR+N 


/ FN 








/ 


/ 



Figure 14-16. CMDUMP 
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where; 



E — Dump exchange package 

D — Dump data manager buffers 

A — Use default exchange package parameter 

B — Use default data manager parameter 

LWA — Last word address of task to dump 

FWA — First word address of task to dump 

OT - Output Queue 

QD — Queue Destination 

AD — Address user called from 

NF — Number of specified files 

FN — Specified file name 

FNC 5 DSDUMP 

Default dump parameters setup for CMDUMP. 



5 4 3 2 1 

98765432109876.5432109876543210987654321098 765432109876543210 



ADDR 


/EDAB 


/ 


LWA 


/ 


/ 


FWA 


/ 


ADDR+ 1 


/ QD 








/ 


OT 


/ 



Figure 14-17. DSDUMP 



where; 



E 

D 

A 

B 

LWA 

FWA 

OT 

QD 



Dump exchange package 
Dump data manager buffers 
Use default exchange package parameter 
Use default uata manager parameter 
Last word address of task to dump 
First word address of task to dump 
Output Queue 
Queue destination 
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FNC 6 Return Terminal Status 

5 4 3 2-1 

98765432109876543210987654321098 7654321098 765432109876543210 



A DDR 


/ 


/ CODE/ LIST 


/ 


LENG 


/ 


RETURN 


/ 


ADDR+1 


/ 


MASK 










/ 


ADDR+2 


/ 


CRIT 










/ 



Figure 14-18. Return Terminal Status 



where; 

CODE 



= If data base name field is to be searched. 
= 1 If user argument field is to be searched. 
= 2 If communication line field is to be searched. 
= 3 If terminal name field is to be searched. 



CRIT — Criterion value for search. 

LENG — Number of words that list can hold. 

LIST — FWA of list of returned terminal entries. If zero, no list is returned, 
but the number of found entries will be returned as specified below. 

MASK - A value taken as a binary mask. 

The field specified by CODE is examined in each terminal table entry by taking the logical 
product of the field and MASK, and then taking the logical difference of this product and 
CRIT. If this result is zero, the terminal entry is placed into LIST and the number of 
found entries is incremented. 



FNC 7 



CRAS Terminal K-Display Command 
59 



A DDR 



Start of Command 



Valid commands are: 

ASSIGN 

CHNGLIN 



OFF LINE 
OFFTASK 
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DROP 


OFFTERM 


DSDUMP 


ONLINE 


DUMP 


ONTASK 


IDLE 


ONTERM 


JEND 


RESPT 


MAXFL 


SWITCH 


MESSAGE 





The command may occupy several words and must end with 12 bits of zero* just as a control 
card would. 



FNC 10 



Set K-Display to Run From a Task 

59 



A DDR 



K-Display Control Word 



This function is not performed if the K-Display is already being used by a task. This 
function simply replaces the current K-Display control word with the control word given. 
The format of the control word is as follows: 



59 



36 35 



18 17 



KBUF 


LS 


RS 



24 



18 



18 



where: 

KBUF -Address of keyboard buffer (8 words) 
LS — Address of left screen control word 
RS — Address of right screen control word 

NOTE 
Further information on K-Disolav usage is available in Section 19. 



14. 5. 3. 4 TIM - Request System Time /Date 
59 42 41 35 



24 



18 



12 



18 17 



TIM 




OP 




A DDR 



18 
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where; 

OP- Option (0-6) 

ADDR — Address for response 

14. 5. 3. 5 MSG — Place Message on Line One 

59 41 35 23 17 



MSG 





FNC 





ADDR 



18 6 12 6 18 

where; 

ADDR — Address of message to be displayed. 

FNC -Function code. Currently only FNC = 1 is supported. 

Since the MESSAGE macro is used to display the message, the message must 
be in "C" (COMPASS) format. 

Most of the RA+1 request processing routines described previously enter the TSSC sub- 
routine upon completion of the request. TSSC is the subcontrol point supervisor which 
activates a subcontrol point via the XCHNGE macro. TSSC determines which subcontrol 
points are requesting the CPU and determines what servicing to schedule upon return of 
the CPU from a task (at SRTN). If there are any outstanding data manager requests, TSSC 
branches to DMGR (the data manager) before activating a subcontrol point. TSSC also 
monitors PP completion statuses and reinitiates routines when their PP call is complete. 
For example, TSSC restarts task loading after a PP has performed the load, or TSSC 
restarts non-buffered journal file processing as PP completion is sensed. Finally, at 
absolute time intervals, the system monitor drops the CPU from a subcontrol point so that 
control can be returned to the main loop for time -dependent processing. This time interval 
is defined by symbol TSL in T RAN EX and is currently 200 milliseconds. Control returns 
at SRTN which checks error exit flags and RA+1 requests from the subcontrol point pro- 
gram. As mentioned earlier, if an RA+1 request is present, one of the processors 
described previously is executed. 

TMDC calls the task scheduler (SCHD) every SCHTL milliseconds (currently SCHTL=60). 
SCHD searches the requested task list (RTL) for the highest priority task, requests enough 
core to run the task (via subroutine RMEM), and (if core is available) initiates loading of 
the task. The RTL is one of two tables assembled within TRANEX and not set up dynamically 
by TRANEX1 (reference Figure 14-15). The other table is a task load request stack with the 
name CCC. The RTL consists of 2-word entries and is currently 120B words long; while 
CCC consists of three 2-word entries with a zero-word terminator. The format of these two 
internal tables is shown in Figure 14-20. 
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OP 







Response 



ACCUMULATED CPU TIME 
5 4 3 2 1 

987654321098765432109876543210987654321098 765432109876543210 



A DDR 



ADDR 



/2 / SECONDS 



/MILLISEC. / 



1 DATE 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



/ * YY/MM/DD. * 



I 



2 CLOCK 

5 4 3 2 1 

9876543210987654321098765432109876543210987654321098765432.10 



ADDR 



ADDR 



/ * HH.MM.SS. 



3 



/ 



JULIAN DATE 
5 4 3 2 1 

9876543210987654321098 7654321098 7654321098 765432109876543210 

7 o "■"/'"" Yyddd" / 

4 SCOPE FORMAT REAL TIME (NOT SUPPORTED) 

5 4 3 2 1 

987654321098765432109876543210987654321098 765432109876543210 



ADDR 



ADDR 



/2 / SECONDS 



/ MILLISEC. / 



5 REALTIME 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 



/ SECONDS 



/ MILLISECONDS 



Figure 14-19. OP Response 
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OP 

6 



Response 



PACKED DATE /TIME 
5 4 3 2 1 

98 7654321098765432109876543210987654321098 765432109876543210 



A DDR 



/ 



/ Y-70/ MM / DD / HH / MM / SS / 



Figure 14-19. OP Response (Continued) 



RTL- Requested Task List 



Wl 
W2 



59 47 




41 


29 23 17 


Name 


FL 


CP 


MP 


QL 


CRA 


FRA 


flags 



where: 



Name 

FL 

CP 

MP 

QL 

CRA 

FRA 

flags 



Wl 

W2 

where: 

CPA 
TFL 
SCP 



Task directory index 

Field length 

Current priority 

Maximum priority (future use) 

Queue length limit 

Current ATL entry 

First ATL entry 

bit meaning 

2 ECS resident (future use) 

3 CM resident 

4 non destructive code 

5 system task 

CCC — Task Load Request Stack 



59 


4 


1 


35 


29 


17 


CPA 




TFL 


SCP 


TLN 


RDA 
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Subcontrol point area TLN 

Task field length RDA 

Start of subcontrol point FL 

Figure 14-20. RTL and CCC Internal Tables 



Address of task library name 
Random disk address of task 
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14. 6 TRANEX2 - RECOVERY/END PROCESSING 

In general, TRANEX2 performs the following operations: 

• Flush buffered journal files 

• Issue statistics to the dayfile 

• Dump TRANEX field length 

• Restart the subsystem 

TRANEX2 is loaded over the K-Display processing code within TRANEX and currently 
cannot be expanded by more than 64B words. 

Figure 14-21 is a flowchart of REC, the main control portion of TRANEX2. 
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•Random 
Index re 
turn'd in 
•FET + v 6 
es 





Set working 

buffer 

address in 

Rollout FET 



Load F L in 

front of 

TRANEX2 

TRFL-KDIS 

4 



Skip over 
KDIS code 



Load FL 

after 

TRANEX2 

code 




MESSAGE \ 

RECOVERY \ 

.IMPOSSIBLE / 





Check for 

assigned 

equipment 



RJF 



Recover 

Journal 

Files 



IDS 



Issue 

Dayfile 
Statistics 




MESSAGE 

TRANEX 
TERMINATE 



Call ITP 
to restart 
TRANEX 

tt.x 




Figure 14-21. REC - Recovery Processor from TRANEX2 
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STIMULATOR 15 



The Stimulator is a program that acts as a load simulator on the KRONOS system. A load 
simulator i3 a procedure in which a small-scale computer (simulating communication 
network terminals) is programmed to transmit data into a large- scale computer using 
the required number of communication lines 

The small-scale computer is programmed to accept input data and control traffic over 

the communication lines. The large-scale computer functions in the same manner as if the 

remote terminals were actually being used. 

The organization of the CDC CYBER 70 computer system allows one PP program to commun- 
icate with another composed of a set of programs, one of which is a dedicated PP program 
transmitting data to and receiving data from the KRONOS communication driver over a 
data channel 

The PP program actually simulates a 6676 or 6671 multiplexer That is, it responds to 
all function codes issued by the system communications driver in exactly the same manner 
as the multiplexer. To the communications driver and the KRONOS operating system, the 
PP program looks like a communication network of time-sharing users . 

The Stimulator can be used to : 

• Load the system for system checkout 

• Gauge system performance 

• Measure response times under varying loads 

15.1 TELEX/ TRANEX 

The TELEX and TRANEX stimulators work in the same basic way Two PP's can commun- 
icate to each other via a channel; 1TD can transfer data to TELEX in such a way that TELEX 
can not tell if the input is from a live MUX or a simulated MUX. 

Hence, stimulator receives standard session file information from a user- supplied input 
and multiplies them as directed by K display commands and transmits the session file 
across a channel to 1TD 1TD needs to realize the input is from a PP rather than a MUX 
only in the way he functions, reads, and writes across the channel. From that point on, 
analyzing and transmitting the data to TELEX is identical to a live MUX. Hence, most 
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of the driver and all of TELEX and TRANEX cannot discriminate real traffic from stimulator 
traffic. 

The stimulators are composed of a CP program and a PP program The CP program controls 
the speed and repetitions of the session file. The PP program actually communicates with 
1TD across a channel. 

Normally 1TD just functions and inputs across the MUX channel 

However, for stimulators, 1TD cannot input until the stimulator is ready to output and 
vice versa. Hence, 1TD and the stimulator PP are synchronized since 1TD covers all 
the MUX'S in a prescribed sequence, and the PP doing the output will wait until the other 
PP performs an input These are sequenced so that 1TD will not get hung on input and 
miss some other MUX or stimulator input. 

For example, in a very simplified way Figure 15-1 shows 1TD communication with a real 
MUX 



MUX 



1TD MUX buffer 





Channel 



































TELEX 




Figure 15-1. 1TD Communicating With MUX. 

1TD inputs /outputs data from the MUX into its buffer at any time it desires and then 
processes the buffer. 

Figure 15-2 shows 1TD communication with a stimulator PP. 



15-2 
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stimulator 
buffer 



I 



1TD MUX buffer 




^ 





Channel 

M . : », 



































t Jltt} 



TELEX 



J 



Figure 15-2. 1TD Communicating With PP. 

1TD must input/output data from the stimulator only when the stimulator PP is correspond- 
ingly output/input across the channel. Once the input/output is complete, the buffer is 
handled in exactly the same manner as a true MUX buffer. 




Figure 15-3. Stimulators 
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1. Referring to Figure 15-3, a session file is produced by the user. (In the case 
of TRANEX, a previously defined data base and task library must exist. 

2. The file is read by the CP portion and is duplicated and time -controlled to 
send transactions or commands. 

3. The PP portion receives the data from the CP portion, connects the free 
channel and transmits the data across the channel. This data looks identical 
to real MUX input. 

4. 1TD recognizes this as a stimulator channel (by the MUX table) and inputs the 
data It then treats it as any normal MUX input and the rest of 1TD is normal. 

5. TELEX receives the POTS, processing them, which can generate output POTS. 
Live and stimulated traffic are processed exactly the same. 

6. 1TD picks them up in a normal way However, 1TD realizes the output is 
meant for a stimulator and outputs on the stimulator channel. 

7. The PP portion collects the output and sends it to the CP portion. 

8. The CP portion times responses to the stimulated traffic and collects other 
information for use by the analyst 

The user can vary the extent of the load, and specify the manner in which the simulated 
load is to be run, together with the frequency and number of terminals logging in . 

A test program to be run under the Stimulator must resemble a typical session at a time- 
sharing terminal or transaction terminal. Each test program includes: 

Terminal log- in 

A source file 

Any necessary terminal commands 

All necessary data 

Terminal log- off 

The system processes the program the same as a program from a time-sharing terminal. 

15.2 TELEX STIMULATOR 

The TELEX Stimulator simulates up to 8 multiplexers and 512 TTY users. The Stimulator 
is quite useful in benchmarks and demonstrations, as a device for loading the system during 
Q.A., and for actually QA'ing TELEX after making enhancements 

The Stimulator operates by actually feeding data into the TELEX POTs which are handled 
as though it is data from a TTY user. The Stimulator feeds data to TELEX at about the 
same speed as an actual user. Jobs are submitted to control points and the output is 
returned to the Stimulator . 
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15 2.1 Stimulator Requirements 

Three items are necessary to allow the Stimulator to run: 

1 . Entry in the VA LI DUX f ile . 

2. A dummy 6676 entry in CMR = EST entry for a free channel must be specified. 

3. A Stimulator input file on a permanent file. 

15.2.2 Operation of the TELEX Stimulator 

1 . At deadstart time a dummy entry for a 6676 multiplexer must be made to 
CMR A sample entry would look like the following: 

EQ30 = TT, OFF, 0, 1, CH, 0, 20 . Refer to Part II, Section 4 of the 

Installation Handbook.) 

The CH = a free channel. This is very important. If there is any equipment 
on this channel, it will cause the Stimulator and TELEX to hang their associated 
PPs. After this entry is completed, KRONOS is ready to deadstart. 

The IPRDECK should also be checked to verify that AUTO is not selected. 
If it is, enter AUTO again to negate the selection. 

2. Do a MODVAL run entering in legal account numbers and passwords that 
match those on the Stimulator input file. These entries must be made 

and made correctly or the Stimulator will not run . Figure 15-4, example 1 
Stimulator input file requires the following entries in the VALIDUX file: 

a. Account Number = SKUJINS PW=JURIS 

b. Account Number - KIRKLND PW=CLAY 

Figures 15-5 and 15-6 Example 2 requires the following entries in the VALIDUX 
file: 

a. Account Number = BOBSIM1 PW=7744526 

b Account Number = BOBSIM2 PW=7744526 

c. Account Number = BOBSIM PW=7744526 

3. Make the following entry, "UNLOCK". This unlocks core for the following 
entries to core if needed. 

4. Enter EB. This gives you the console E display on the left hand CRT The 

E display is a display of the Equipment Status Table (EST) . In the upper right 
hand corner of the display is the EST FWA. This address is needed to change 
the EST ordinal for the dummy entry of the 6575 multiplexer. 

5. Enter "C4.EST FWA + ORDINAL NUMBER OF MULTIPLEXER". Take for 
instance that the EST FWA is 4600 and the ordinal entry of the 6676 in CMR 
is EQ30. The entry would be then C4, 4630. After this entry, the location 
4630 is then displayed on the left hand scope. 

6. It is now necessary to ensure that the EST entry is correct in central memory 
resident and if not, correct it. 

The detail format for the MUX is shown in Part II, Section 4 of the Installation 
Handbook. A general format is reproduced here. 
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EQord = TT, status, controller, 0, channel, 0, lines, for a real MUX 

EQord = TT, status, controller, no, channel, 0, lines for a dummy MUX . 

If the following entries were used in the CMR deck: 

EQ30 = TT, OFF, 7, 0, 4, 0, 20 

EQ31 = TT, OFF, 0, 1, 11, 0, 20 

then the EST entry can be seen in the dump in Section 27 of this manual 
address 6630 and 6631. 

6630 = 2000 0004 0020 6424 7000 

6631 = 2001 0011 0020 6424 0001 



The general format for the EST entry is: 
6 6 6 6 12 



~up — 

number 



11 



A. 



20 



channel 
no 



Number of 
lines (ports) 



TT 



eq 
no 



stim . 
type 



20 = Device available for use . 

CP number = CP currently assigned, (Normally TELEX will have this device 
assigned and CP number =1) 

* 2 Bit 23 = = device status ON 
1 = device status OFF 

eq. no. = Controller number 

stim type = Real MUX 

1 Time-sharing stimulator for either 6671 or 6676 

2 TRANEX stimulator for 6676 
4 TRANEX stimulator for 667 1 

Now, either entry can be dynamically created by entering data into core . The 
number of lines can be dynamically changed by entering data into core as 
follows . 

6631,2,30. would make the Stimulator stimulate 30 lines. 

The command format is* : 

address, Byte number, 12-bit value, or 
address, 60-bit value. 

When the entries have been created to the user's satisfaction, he can 
continue . 

Enter ONXX.jOjwithXX having the value of the EST ordinal number of the 
6676 dummy \J7entry. in the preceding examples EQ30 was used as the 
EST ordinal. Therefore, you would enter "ON30,,OV EQ31 was the 
stimulator EST ordinal so also enter ON3l£>y K^7 

Refer to Section 3, Memory Entry commands of the Operator's Guide 
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BNCHMARKOlv 

SKUJINSv 

JURISv 

FORv" 

NEW, RALFv 

10 PROGRAM RALFflNPUT, OUTPUT, TAPES=INPUT, TAPE6 = OUTPUT)v 

20 READ (5. 9) ANGLE!, ANGLE2, ANGLE3, ANGLE4v 

30 RAD=57. 29573v 

40 A=ANGLEl/RADv 

50 B = A NGLE 2 / P. A Dv 

60 C=ANGLE3/RADv 

70 D=ANGLE4/RADv 

80 Sl = SIN(A)v 

90 Cl = COS<A)v 

100 Tl = TAN(A)v 

120 CO! = lTlv 

130 \VRITE(6.1) ANGLEl.Si, CI, Tl.COlv 

220 S2=SIN(B)v 

240 C2 = COS{B)v 

250 T2=TAN(B)v 

260 C02=l/T2v 

270 WRITE (6. 1) ANGLE2, S2, C2, T2,C02v 

300 S3=SIN(C)v 

320 C3 = COS(C)v 

330 T3 = TAN(C)v 

340 C03 = l/T3v 

360 WRITE (6. 1) ANGLE3, S3, C3, T3, C03v 

410 S4 = SIN(D)v 

430 C4 = COS (D)v 

450 T4 = TAN(D)v 

460 C04=l/T4v 

470 1FORMAT(*ANGLE=*,F4.0,*SIN=*,F6.2,*COS=*,F6 2.*TAN=* F6 2v 

480 +* COTAN=*F6.2)v " 

500 WRITE (6. 1) ANGLE4, S4, C4, T4, C04v 

510 9FORMAT(4F4.0)v 

520 CALL EXITv 

530 ENDv 

RUNv 

30. 45. 60. 90. v 

BYEv 

i : (this punch is not necessary for KRONOS V2 1) 

000000000000000000000000 (e or punch 7/8/9) 

BNCHMARK02v 

KIRKLNDv 

CLAYv 

BASv 

NEWv 

ROBINv 

10 REM PROGRAM ROBINv 

12 Nl=9v 

14 LET Ll = 1000v 

16 LETK=Sv 

18 LET N=lv 

20 K=K+lv 

22 IF K<=N1 THEN 30v 

25 SlOPv 

30 N=K+Nv 

32 IF N>=L1 THEN 18v 

34 L=0v 

38 J=Nv 

Figure 15-4 Stimulator Input Files, Example 1 

97404700A , =• 7 
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40 J=J-lv 

44 M=INT (J/K)v 

48 B= J-K* Mv 

50 IF B< X) THEN 30v 

55 LET J=J-Mv 

58 L=L+lv 

60 M=L-Kv 

65 IF M<=0 THEN 40v 

70 PRINT K, Nv 

75 GO TO 18v 

80 ENDv 

RUNv 

BYEv 

h (this punch is not necessary for KRONOS V2. 1) 

000000000000000000000000 (eor) 

0000000000000000000000 (eof punch 6/7/8/9) 



Figure 15-4. Stimulator Input Files, Example 1 (continued) 
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Example 2 needs the permanent files created by the following two decks, 

5TIMA,CMi2000, T7777.P77. 

ACCOUNT, BOBSIM2, 7744526. 

COPYBRdNPUT, TESTA) 

SAVE, TESTA. 

(eor punch=7/8/9) 

00010 TESTA 

00120 GHI 

00130 KKK 

00140 AAA 

00150 BBB 

00160 CCC 

00170 DDD 

00180 EEE 

00190 FFF 

00200 GGG 

00210 HHH 

00220 m 

00230 JJJ 

00240 LLL 

00250 KKK 

002 SO MMM 

00270 NNN 

00280 OOO 

00290 PPP 

00300 QQQ 

00310 RRR 

00320 SSS 

00330 TTT 

00340 UUU 

00350 VW 

00360 "WWW 

00370 XXX 

00380 YYY 

00390 ZZZ 

910 NOMORE PLEASE 

920 YOU NEED MORE 

930 MY FRIEND 

940 SOLD TO MLO 

950 STICKS AND STONES 

960 HURT LIKE HECK 

970 AND SO DO HOLDERS 

980 BUT WHAT CARE I SAY THIS MACHINE 

990 TISS TOWARD THE END 

1000 THE END PART 2 TEST A 

/ j* _ t= - m _v I ^£»/rr/ri t r\\ 

Vfc!Ui pUncn=0/ 1/ 0/ 3! 

STIM, CM12000, T7777, P77. 
A C COUNT, BOBSIM 1,7744526. 
COPYBRdNPUT, TESTB) 

SAVE, TE STB. 
(eor punch=7/8/9) 
010 TESTB 
00100 ABC 
00110 DEF 
00120 GJO 
00130 KKK 
00140 AAA 
00150 BBB 
00160 CCC 

Figure 15-5. Stimulator Input Files, Example 2 
Permanent Files Decks 
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00170 DDD 
00180 EEE 
00190 FFF 
00200 GGG 
00210 HHH 
00220 m 
00230 JJJ 
00240 LLL 
00250 KKK 
00260 MMM 
00270 NNN 
00280 OOO 
00290 PPP 
00300 QQQ 
00310 RRR 
00320 SSS 
00330 TTT 
00340 UUU 
00350 VVV 
00360 WWW 
00370 XXX 
00380 YYY 
00390 ZZZ 
900 HI GANG 
910 NANN 
930 FRAN 
950 FLILL 
960 HOBOY 
970 OUCH 
980 980 

990 NINE NINTY 
1000 THE END 
(eof punch=6/7/8/9) 



Figure 15-5. Stimulator Input Files, Example 2 
Permanent Files Decks (continued) 
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Example 2 Stimulator input file is created by the following deck on permanent file STIMFL. 

STIMM, CM12000, T7777, P77, TP1. 

ACCOUNT, BOBSIM, 774452 6. 

COPYBRffNPUT, STIMFL) 

SAVE, STIMFL 

(eor punch) 

ANSWERBACv 

BOBSIM lv 

7744526v 

BASICv 

OLDv 

TESTBv 

LIS,294v 

297 ERROR AAAAAAAAAAAAAAAAAAAAAAAAAAAAAv 

298 ENDv 
LIS,296v 
297v 
RUNv 
OlOOOv 
OlOv 
OlOv 
STOPv 
298 ENDv 
RUNv 
OlOOOv 
OlOv 
OlOv 
STUPv 
REPLACEv 
BYEv 

(eor punch) 

ANSWERBACv 

BOBSIM2v 

7744526v 

FORv 

OLDv 

TESTAv 

LIS, 753v 

RUNv 

20000v 

OlOOOv 

.08v 

4v 

752C AAAAAAAAAAAAAAv 

753C BBBBBBBBBBBBBBBBv 

LIS, 752v 

REPLACEv 

RUNv 

20000v 

OlOOOv 

.08v 

4v 

BASICv 

OLDv 

TESTCv 

Figure 15-6. Stimulator Input File, Example 2 
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LIS,210v 

RUNv 

400v 

REPLACE, TAPE lv 

BYEv 

(eor punch) 

ANSWERBACv 

BOBSIMlv 

7744526v 

BAS,OLD,TESTBv 

LNH,294v 

297 ERROR AAAAAAAAAAAAAAAAAAAAAAAAAAAAAv 

298 ENDv 

297 ERROR BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBv 

297 ERROR CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCv 
LNH,260v 

297v 

RUNv 

OlOOOv 

OlOv 

OlOv 

STOPv 

298 ENDv 
RUNv 
OlOOOv 
OlOv 
OlOv 
STOPv 
REPLACEv 
BYEv 

(eor punch) 



Figure 15-6. Stimulator Input File, Example 2 (continued) 
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8. Enter TELEX.O. (If any control point activity is present, enter BLITZ 
before entering^ TELEX. ) TELEX now comes to CTL.PT. 1. 

9. See Chapter 4, Section 5, of the Installation Handbook for the description of 
how to start the Stimulator. 

10. To watch TELEX operate, enter TB.<5>. This will give you the TELEX 
display and allow you to monitor the ^Stimulator activities . 

11. Once TELEX has been activated and the Stimulator is running, AUTO can 
be entered to initiate BATCHIO, and automatic job processing. AUTO must 
be entered if a BLITZ was entered. 



15.2.3 Input Data File 

The Input Data file is an item required by the Stimulator. The file must contain all of the 
information a TELEX user would enter if he were working from a TTY. This includes the 
user account number, his password, and files and commands he may wish to submit. The 
file must be in the following format: 

1. Data Tape File Identifier (10 Char. Max) 

2 . Valid User Account Number 

3. Valid User Password 

4. System (FORTRAN, BASIC, NULL, etc> 

5 . File Name (OLD, NEW, LIB) 

6. Data (maybe a program) 

7. Legal TELEX Command (RUN, LIST, SUBMIT, etc.) 
8 Data for a Program 

9. BYE 

10. A telephone Logoff Character (\ ) the down-arrow. 

11. AnEOR 

Each and every line of data must be followed by the V symbol. This is the character 
TELEX recognizes as the TTY carriage return. Each entity of a group of a user's typical 
data and commands must be followed by an EOR (end of record) . This is necessary for 
the Stimulator to distinguish between each element. The two special punches are: 

1 . f = 11/8/6 punch - only used for KRONOS V2 . 

2. V= 11/0 punch 

A further discussion of the Simulator file follows 

To create a Stimulator load (test) file, each file must have the following format: 

1. 1st card - answerback code (10 characters or less) followed by the down 
carat (V, 11-0 punches). 

2. 2nd card - user account number followed by a down carat. 
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3. 3rd card - password followed by a down carat. 

4. 4th card - system desired, BAS, FOR, EXE; followed by the down carat. 

5. 5th card - file type - OLD, NEW, or LIB; followed by a down carat. 

6. 6th card - file name followed by a down carat. 

7. The body of the program, if a new program. Each card of the program MUST 
terminate with a down carat. 

8. Any command desired, i.e., RUN, SAVE, etc. followed by down carat. 

If data is required for a RUN, the data must follow the RUN command. Each data 
card must terminate with the down carat. 

9. Any other sequences of commands, i.e., LNH, LIST, correction lines or additions 
to programs, etc., each followed by a down carat. 

10. The next to last card must be the BYE command followed by a down carat. 

11. The last card must be a down arrow ( +, 11-8-6 punches) for KRONOS V2.0. 

12. After the down arrow, put an end-of-record card (7-8-9 punches). 

Each program MUST be entered on the load (test) file as an individual record . The 
Stimulator is capable of pulling off individual records as separate program sequences 
so that each TTY doesn't have to run the same set of programs. This allows greater 
flexibility in the stimulated load placed on the system (i.e., it is easier to approach a real 
world work load). After the last end-of-record card put an end-of-file card (6-7-8-9 punches). 
All cards must be punched starting in column 1, 

15 3 ' TELEX STIMULATOR SOFTWARE DESCRIPTION 

The TELEX STIMULATOR is composed of one CP program, STIMULA, and one PP 
program ITS. 

When the DSD command STIMULATOR is sensed by DSD, DSD will call IDS to process 
the request. IDS will create an input queue entry for ITS. 1SJ will initiate ITS as a 
subsystem. ITS will call STIMULA to a CP and prepare to receive session data. STIMULA 
will read the session file, duplicate and prepare it according to the K display parameters 
specified by the operator. STIMULA will then build tables which ITS will use to create 
stimulation traffic to transmit to 1TD. 

Figure 15-7 shows the main flow of STIMULA. 

15.4 TRANEX STIMULATOR 

The transaction stimulator is composed of two CP programs and one PP program. The 
user prepares a session file and calls PRESIM via control card to prepossess the session 

me. 
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/^TIMXA 

t 

PRS 

preset 
code 



TFS 
translate 

session 

file 



ITT 



initialize 
terminal 
table 

I 
RSP 



SSA 






allocate & 
clear recov- 
ery area 



request 
session 
Darameters, 



Degin 
stimulaj 
tibn 



*4 



set session 
address 




Figure 15-7. ST1MULA - Main Program 

* 1 Initialize most tables, tell ITS STIMULA is ready, get session file name, etc. 
*2 Read session file and store in the session buffer. 

* 3 Get the parameters (delay time, number of ports, etc. ) via the 2nd K display 
*4 Relocate indices for tables. 
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The user can develop a program which can communicate with TRANSIM and direct the 
progress of the stimulation. Refer to chapter 9 in the KTS reference manual. The user 
then calls TRANSIM via control card. TRANSIM will start the PP program CS1; then it 
will begin processing the restructured session file produced by PRESIM. TRANSIM builds 
CM tables in its field length which are read by CS1. 

CS1 will transmit the sessions to 1TD and will build CM tables for TRANSIM from the 
responses transmitted back by 1TD. 

15.4.1 CS1 Main Loop 

When the channel goes active, the function code will be accepted by CS1. If it is not an 
output, CS1 is out of synch with 1TD. Otherwise, CS1 accepts nl number of words of 
data, and sets up the pointers in TT, TA, and the CM buffers. Then CS1 processes the 
output from 1TD and sets up the next input to 1TD. 

CS1 waits until the channel goes active again, picks up the function code and verifies that 
it is an input. If not input, then CS1 is out of synch with 1TD; else transmit the output to 
1TD. 

The MUX pointer is then set to the next MUX, CSl pauses for relocation, and then starts 
the main loop over again . 

If CSl is ever out of synch with 1TD, it will issue the message "OUT OF SYNCH" and 
terminate the stimulation. 

15 4.2 CSl Internal Descriptions 

CSl - PP portion of the transaction terminal stimulator. CSl is called by the CP portion 
of the stimulator and performs all interface functions to 1TD (the normal TELEX terminal 
driver). CSl will appear to 1TD as if a real MUX(es) was on the other end of the channel 
from 1TD. In the case of the non "direct" channel transfer, a special EST entry is required 
for CSl to know the channel desired for running the stimulated terminals. The channel 
number for this EST must be an unused one or the equipments on the channel, 1TD and CSl, 
will not operate properly. CSl will get the terminal input from CM buffers handled by the 
CP program and will put terminal output into CM buffers handled by TRANSIM. 
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Special EST entry format: 
12 12 



12 



12 



12 



2000 J 00 ch 


numoer oi 
lines 


2424 


SOB 



where: 

ch 



channel number to use 



= e 



^uipiuc 



E = equipment number 

For the direct coupled assembly, TELEX does not have to be dropped and CS1 is not as 
sensitive to what is on the channel. The direct assembly will not function the channel so 

there can be equipment on the channel while the stimulation is running 

logic flow - CS1 



1 . Initialization 

• Initialize tables. 

• Wait for TELEX and TRANEX to come up 

Note: If channel I/O CS1 waits for TELEX and TRANEX to be dropped 

2 . Main Loop 

• Check line buffers for available data. 

• Communicate with 1TD 

• Process output data. 

3. End 

• Request TELEX be dropped if channel coupled. 

• Turn off stimulated MUX if channel coupled . 

• Drop control point if an abort caused the end. 

15.4.2.1 Line Buffer 

CS1 makes use of a series of buffers in the CM field length of the stimulator One of 

it---* 1 rr*~£. -„"n «— £ ~± f-.«. AA A U 1-;-»a «•■. Art «Vi g +-;■•■*-. t-»1 rt + en-1 1\/TTT"V TV*pi f**n"Trto + f*f o lino l-Miff i»T* i <3 • 

1. Word 1 



42 


6 


R fi 


terminal name 





flags pc 



where: 

pc - polling code for current terminal 

flags - 

Bit 11 - 1 when the CPU has put into the buffer an input transaction 
(Set by CPU) . 



97404700A 



15-17 



Bit 10 - 1 when CS1 has passed the message onto TELEX and TELEX 

has accepted it (set and cleared by CS1) Bit 11 will still be set 
when this bit is set to 1 . 

Bit 9 - When no more input for this line (set by CPU) . 

Bit 8 - When output available (set by CS1, cleared by CPU). 

CPU sets bits only when they are all cleared. The CPU clears them when 
the transaction is written out. 

Words 2-15 

66 



data 



where: 



data = input transaction to TELEX will be put here. The message will be all 
display code and will contain a 73B terminator (Set and cleared by the 
CPU) . The message will never be cleared out before another is put in. 



3. Word 16 

60 



time in 



where: 

time in = time the CPU put the last message into the input buffer (set and cleared 
by the CPU) . 

4 Word 17 g0 



time out 



where: 

time out = time the first character was placed in the output buffer (set by CS1, 
cleared by CPU) . 

5. Words 18-20 

60 



data 



where: 

data = output from TELEX is put here in display code (set by CS1, cleared by CPU). 

15.4.2.2 TT For CS1 

The main control table for CS1 is the TT. There is one TT for each line on each stimulated 
MUX. Each TT is 5 bytes long The tables are allocated at CSl preset and the address 
of the first TT of the group is in the direct cell TT These tables are PP resident. 

TT Format consists of the following five bytes. 
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Byte - used to point into the TA CM assembly/disassembly word. 

6 6 



char 


word 



where: 

char = next character position to use in the TT. Value is from to 9D, where 
= left-most character position. This is used to insert and remove 
characters into/from TT. 

word = relative address of current CM word in use in the CM message buffer. 
This is used when reading a transaction from the CM buffer to give to 
1TD, and when transferring output from 1TD to the output buffer. When 
word = 0, the 1st word of the area is in use. 

Byte 1 - Address 

12 



aHHrpQQ 



where: 

address = address of next routine to use in processing this line. 

Byte 2 - Flags and Polling 



Flags 



ti 



where: 

flags = 11, 7, 6 

Bit 11-1 when the last sequence from 1TD was a select. 

Bit 7-1 when ETX is received from system and cleared at 
completion of poll or select (output) . 

Bit 6 - not used 
ti = polling code for this terminal (terminal ID) 
Byte 3 and 4 - 



3 


9 


sq 


bcc 



where: 

sq - sequence number for 1TD-CS1 coordination 

bcc - block check character (longitudinal parity) All characters sent to 1TD go 
into the calculation of the bcc except the delay word (see DL parameter 
in this section and bcc itself). 

15.4.2.3 TA Tables 

The TA tables are used for assembling/disassembling words from CM. There is one TA 
table for each line on each stimulated MUX. Each TA is 5 bytes long and is PP resident 
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The TA tables are set up at CS1 preset and the address of the first TA is contained in the 
direct cell TA. 

When the TA is used for reading the transaction from the CM transaction buffer, the 
contents of TA will match the contents of the current word of the transaction buffer. When 
the TA is used for putting the output from a transaction into CM, the TA will be filled with 
output data one character at a time. When it is full, it will be put into the CM output 
line buffer. In both cases, the contents of the -word- counter in the TT byte will also 
point to the current word of the CM buffer. 

NIXDORF line protocol: 

Sequences received 
poll 



select 



- C T B 






/ I c 






R C 






- C TB 




E 


/ I c ■ 


- up to 80 data characters 


- T 


R C 




B 



or 

C T-B E 

/ I C - up to 80 data characters -T 

X 



Response sequences: 

to poll 

no data - C 

/ 
R 

data - C T B E B 

/ I C - input data - T C 

X C 

to select - C T B 
/ I C 
R C 



Characters: 

C 

/ - command response character 
R 



15 _ 2 o 97404700A 



Bits 11-8 - for use of MUX 

7 - (indicates not data char.) 

0~ *j ~ S£Q HotlCS rillXIl vSX* 

4-1 - poll, select, data, no data codes 
- parity (lower 8 bits only, odd) 

T - terminal identifier (polling code) 

I 

B 

C - block check character (longitudinal parity) 

C 

Data character 

Bits 11-8 - for use of MUX 

7 - 1 (indicates data character) 
6-1 - character (ASCII) 

- parity (on lower 8 bits only) 

Note 
If DEBUG is defined as an assembly constant, a CS1-TRANSIM debug package 
is assembled. 

If DIRECT is defined as an assembly constant, the code to communicate directly 
with 1TD will be assembled. If not, CS1 talks down the designated channel. 

15.5 PRESIM 

PRESIM generates input for TRANSIM and in some cases, TELEX and TRANEX. TRANSIM 
inputs the file containing the reformatted user terminal names and transactions . TELEX 
and TRANEX input SIMFILE. 

Error messages are written on the file OUTPUT. 

Control card call: 

PRESIM (PI, P2, P3, P4, P5, P6) is defined in Section 9 of the KTS manual. 

PRE(N) main processing loop. 

Function of routine - 

Main program loop processes the session file (I) containing terminal names and 
transactions. 

Format of file (I) 

Each logical record contains one or more terminal names each followed by one or more 
transactions. If two consecutive terminal names are encountered, a diagnostic is written 
to file (0) for the first terminal name and the second terminal name is assumed valid. 
Terminal names are verified against the names in the terminal name table (TNT) generated 
from SIMFILE, Delay and repeat parameters are decoded. The transaction image is 
not edited. The grouping of terminal names and transactions by logical record generates 
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an index entry for the corresponding logical record on file (N) . Process control is passed 
to the various subroutines based on the status resulting from the process next card (PNC) 
routine . 

Three conditions are possible - 

1. (XI) are not zero, i.e., an EOR/EOF occurred. 

2. The (CTE) are not zero, indicating a terminal name card occurred 

3. Otherwise, a transaction image occurred. 

Entry - (Bl) = 1 
Exit - None 

Routines called - PNC, PIP, WIN, WTR, WIN, READ, RECALL, CLOSE, WRITER, 

ENDRUN, ERR 

Data areas - INC, TTL, TNC, I, PBF, N, O, ATM, TNC 

Registers used - A - 1, 2, 4, 6 

X - 1,2,3,4,6,7 
B - None 

15 6 TRANSIM 

The STIMULATOR provides a means of exercising the system for reliability and Q. A. 
purposes . System changes can be made and a load created via the stimulator which 
duplicates live environment usage 

TRANSIM cracks the control card (see Section 9 of 'the KTS manual) and picks the necessary 
fields from it The following fields are interpreted: 

P=lfn where lfn is the file which contains the user transaction data. The 

default is NEW. 

R=nnn Run the input nnn times. The default is one 

DL=nnn Delay nnn seconds between inputs (0-600 seconds). The default is 
10 seconds. 

0=lfn Output is put on file lfn. If lfn is not designated, the OUTPUT is dropped. 

B=lfn The users program is found on lfn in absolute program format The 

default for lfn is LGO. 

D - The D option allows the application programmer to debug his program 

without going to the TELEX system with the input. The program will 
not call CS1. It is up to the user to set the write bit if he wants to 
write the transaction out after processing it. If the input ready flag 
is not cleared, control will not return to the user on the line. If no load 
file (B) is designated, the transactions are copied to the output area and 
set ready to be written to the OUTPUT file. If there is no OUTPUT 
file, the transaction is not copied. 
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NR 



Don't rewind the output file before writing on it. The scratch file is 
rewound unconditionally. 



LN-nnn Number of lines is equal to nnn. 

The input file for the STIMULATOR is card image format. The transaction should appear 
exactly as an operator would type at the terminal. Terminal function keys (unlock keyboard, 
send, etc.) are not represented in the format. 

User Interface - Common area USR for communication between user program and 
TRANSIM. 

Word Meaning 

1 =1 - preview, =0 - review 

2 time delay in seconds 

3 repeat count 

4 current buffer number 

5-n random address for each line (total of n lines) 

n-m input and output buffers 



Output Format 
42 



12 



terminal name 



flags 



"I polling 
I code 



where: 



Flags 11, 10, 9, 



Bit 

11 
10 

9 

8 



Meaning 

input for CS1 

input has been sent 

EOR - no more input available for this line 

output available 



input data area (13 words) 
time of input 

time of output was received 
output data (62 words) 






24 


18 


18 


| hour 


minute 


second 



Random Index/ TRANSIM Next-Read Table 
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Current terminal name 

14 21 



30 



delay time 



status 



out 
address 



in 
address 



random address 



The table is two words long for each line. 



Data Format 





12 


6 


terminal name 





pc 



where: 



pc = polling code 



followed by data terminated by a zero byte 
TRANSIM-CS1 central memory interface 



Word 
lO-(SCMP) 

14-(ESTI) 
15-(CMMN) 

16-(CMWW) 

11-13 

17-21 



Byte Meaning 

length of a line buffer and output on or off bit (59) 

3-4 address of 1st line buffer 

4 unless run to be aborted 

20 MM MM = starting MUX number 

4 1 for recall 

4 until POLTBL construction 

CS1 debugging aids 

CS1 debugging aids 



15 6. 1 Logic Flow For TRANSIM 

1 . Initialization 

• Crack control card parameters 

• Setup CS1 communication area 

• Call CS1 

• Preset line buffers 

• Read random file index to USR (for user program) common area 

• Setup USR (for user program) common area 

• Transfer poll table to CS1 

2 . Main Loop 

• Process each line to put data into its buffer 

• Process USR own-code entrance - preview 

• Process output data 

• Process USR own- code entrance - review 

3. End 

• Complete all active files 

• Put out correct dayfile messages 
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15.6.2 TRANSIM Messages 

1 . COPYING DATA TO THE OUTPUT FILE 

The output data is written to a scratch file as one large logical record. This 
scratch file is reblocked to the user designated OUTPUT file. 

2 . STIMU LA TION EN DE D 

Stimulation input has been exhausted; all output has been received from 1TD 

3. SUB-CONTROL POINT ERROR 

The user has committed a fatal sub-control point error TRANSIM issues 
the message and aborts. 

4 . INPUT IS MISSING RANDOM INDEX 

The input file does not have a legal random index as its last record 

TRANSIM load error-premature end of load file. An end of record was encountered 
before the identification tables had ended. Also, an unrecognized table may have 
been encountered. 

5. TRANSIM LOAD ERROR-COMMON AREA TOO SHORT 
The USR defined area is not large enough for this run. 

6. TOO MANY TERMINALS 

The number of terminals designated to be stimulated is greater than the number 
that TRANSIM is assembled for. 

7 . ERROR IN TRANSIM ARGUMENTS 

The control card parameter is bad. TRANSIM issues the message and aborts 

8. MAXIMUM NUMBER OF LINES ARE XXX 
There are XXX lines of data available 

9. REPEATING INPUT 

Each time the input is repeated, this message is put out 
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EXPORT/IMPORT 16 



16. Q INTRODUCTION 

The EXPORT /IMPORT subsystem coordinates communication between Control Data 6000 
Series or CYBER 70 computer systems and remotely located 200 User Terminals. 

16.1 EXPORT /IMPORT PROGRAMS 

The EXPORT /IMPORT subsystem consists of the following programs: 

E200 CP - CPU Program 
1LS — PP Program — transient 

1ED — PP Program — dedicated 

XSP — PP Program — transient 

16, 1. 1 E200 CP is a CPU program which reformats input/output data of the 200 User 
Terminals. Its Field Length {FD is also used for all the communication tables and FETs 

for the subsystem. The common deck, COMSEXP, is used to establish the constants, 

pointers, and communication table areas. Figure 16-1 shows the layout of these areas. 

A local RPL for the 1LS overlays is contained in the E200CP area. The FETs and buffers 
are kept in the upper portion of the FL, so that they may expand and contract as the need 
arises. Figure 16-2 shows the E200CP core layout and its interaction with the three other 
routines of this subsystem. It also illustrates the subsystem interaction. 

16. 1. 2 IIS is a transient PP program which processes and assigns files, performs 
functions for 1ED, and is the EXECUTIVE routine for the subsystem. 

16. 1. 3 1ED is a dedicated PP program which controls communication between the CDC 
6000 Series or CYBER 70 computer systems and the 200 User Terminals. 1ED must get 
E200CP out of auto-recall when there is input to process. 1ED must convert the output 
to 200 User Terminal format and output to that terminal. 1ED is the only program con- 
stantly running in the subsystem and polling the 6671 multiplexer. 

16. 1.4 XSP is a transient PP program which is called by 1LS to perform time-consuming 
tasks. 
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Address 
Relative 
to RA 

DRCL 
FWTL 



W-INT = 



Octal 
0000 



Number of 
Words per 
Entry 



0100 
0103 
0104 
0144 

0244 

0304 
0324 

0344 

0364 

0404 

0405 
0406 



0720 



Number 
System Communication Area of Entries 

r 1 

E200CP auto recall word set by 1ED when some activity is needed 



TFS - Function /Status Table 



MSGB - Message Buffer 



LINF — Login Information 
Table 



CPIK - CPU Interloc Table 



DPJT - Drop Job Table 
PWLT - Password Table for 

VUN 



JST - Job Statists Table 



FAMT - Family Name Table 



NT-TFS=2 



NT-MSGB=4 



NT- LINF = 2 



NT-CPIK=1 

NT-DPJT = 1 
NT-PWLT = 1 



NT-JST = 1 



NT -TFS*N- PORTS* 



NT- MSGB*N- PORTS 



NT- LINF *N- PORTS 



NT- CPIK *N' PORTS 

NT-DPJT*N-PORTS 
NT- PWLT*N- PORTS 



NT- JST *N- PORTS 



NT. FAMT = 1 NT- FAMT*N- PORTS 



1LS recall word auto recall until 1LS is ready from call via TLX 
when DRCL word went non-ze ro by 1ED 
Initialization Flag 



Scanner Position 



The 8 common routines 
defined in Paragraph 16.4 



E200CP Code 



i 



? 



*N- PORTS=16D maximum number of ports in a 6671. 



Figure 16-1. EXPORT Communication Areas 
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Export 

Control 

Point 



*-» A 1 

K- UUliUi 

Tables 



E200CP 
Control Point 
Data Handler 



Allocated 

FETs and 
Buffers 



Export 
Subsystem 



Local 
Overlay 
Library | 



XSP 

Export 

Service 

Processor 



1LS 

Export 
Exec. 



Input and 
Output 
Queue 



Data Channel 




6671 

MUX 



X 



1 of 16 Ports 



Data 
Set 



& 



Data 
Set 





200 

U.T. 
























Printer 


/Displa; 
j Termii 


ial \ 


Card Reader 


- ,. ... -^^"^ 


\_ 




**r 







Figure 16-2. E200CP Layout and Interaction 
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16.2 EI200 OVERVIEW 

Logically, but not physically, Table 16-1 is maintained for each port (16 per mux). Each 
area of the table is detailed in paragraph 16. 3. Figure 16-3 illustrates the sequence of 
operations and data flow of EI200. 



TABLE 16-1. PORT-MULTIPLEXERS MEMORY 
12 12 12 



FUNCTION WORD 
STATUS WORD 
MESSAGE BUFFER 



LOGIN INFO 
TABLE LINF 



CPU INTERLOCK TABLE CPIK 

DPJT And PWLT 

FAMT 



OUTPUT 

FET 

8 WORDS 



BUFFER 



INPUT 

FET 

8 WORDS 

BUFFER 



LINE 

BUFFER 

8 WORDS 

(1 Card Image) 



FUNCTION 
1ED TO 1LS 



CP I/O 

STATUS 



TERMINAL 
ID 



I/O DRIVE 



MUX EQ NO. 



INPUT FET 
A DDR 



24 

NOT USED 



OUTPUT FET 
ADDR 



Messages To /From 
Remote Display Screen 



Display Code User Number 



Jobname 



UI 



STATUS 



Input Active Output Active 



Internal System Jobname 



Response 



Family Name 



Internal System Name 



\ STATUS 
FIRST 

IN 

OUT 

LIMIT 



Internal System Name 



1 



I 

STATUS 

FIRST 

IN 

OUT 

LIMIT 



Input from Card Reader 

comes here via 1ED 
(1 Card Image at a time) 



c 



i 



^ 



* Contains PASSWORD of log in user at log in time until user verified. Used for dropping 
jobs as long as user is connected. 
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w 



(2) 



MUX 





EI200 CP 




EI200 CP 






RA+DRCL , 












SET i 


CALLS 






E200 CP 


-(-) 




(lED J 


E200 CP 












LINE BUFFER 


LINE BUFFER 













1ED reads from MUX to line buffer 
and sets RA+DRCL words non-zero. 
This will take E200 CP out of Auto- 
Recall. 



E200 CP calls 1LS and goes into 
Auto-Recall. 



© 






EI200 CP 



RA+W. INT 



SET> 



E200 CP 



LINE BUFFER 




JOBNAME 


FI 
200 


I 


CP=0 


ID 


EQ 





EI200 CP 



(Ted)*- 



EP200 CP 



LINE BUFFER- 



INPUT FET 



BUFFER 



1 LS sets RA+W- INT non-zero, which 
will take E200 CP out of Auto-Recall. 
1LS calls XSP to create an FNT/FST 
input queue entry for the job' in the 
Line Buffer. Using OBF and 2TJ (to 
crack the job card). 



E200 CP reformats the Line 
Buffer data as 1ED passes it 
and moves the data to the 
Input FET Buffer. 



Figure 16-3, EI200 Overview 
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© 



EI200 CP 



E200 CP 



LINE BUFFER 



INPUT FET 



BUFFER 



FNT 
FST 



JOBNAME 


EI 
200 


I 





ID 


EQ TRK SECTOR 






E200 CP calls CIO to write the data from the Input 
FET Buffer to the disk. 



EI200 CP 



E200 CP 



OUTPUT FET 



BUFFER 




FNT 
FST 



JOBNAME 

i 


EI 
200 








ID 


EQ TRK SECTOR 
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1LS finds an output queue entry and creates a banner 
page in the Output FET Buffer and informs E200 CP. 

© 

EI200 CP 



E200 CP 



OUTPUT FET 



BUFFER 




E200 CP reads the Output File via CIO into the Output 
FET Buffer. 

Figure 16-3. EI200 Overview (Continued) 
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© 



EI200 CP 



(Ted) 






\ 



E200 CP 



OUTPUT FET 



BUFFER 



LINE BUFFER 



o 



E200 CP formats the Output FET 
Buffer for the remote printer and 
informs 1ED. 



MUX. 



EI200 CP 



E200 CP 



OUTPUT FET 



BUFFER 



LINE BUFFER" 



1ED moves the Line Buffer data, one 
line at a time, to the remote printer. 



MUX 



-HIED 




E200 CP goes into Auto-Recall 
and 1ED continues to poll the 

MUX. 



Figure 16-3. EI200 Overview (Continued) 
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16.3 EXPORT COMMUNICATIONS AREAS 

The following functions are processed by 1LS for 1ED. These tables are in the E200CP FL 
and are used for communication areas for all parts of the subsystem. 

TFS - Function Table 

TFS - Status Table 

MSGB - Message Buffer 

LINF — Log -in Information Table 

CPK - CPU Interlock Table 

DPJT - Drop Job Table 

PWLT - Password Table 

FAMT - Family Name Table 



| 16. 3. 1 Function Table TFS 



12 



12 



12 



FUNCTION 
TO EXEC 



TERMINAL 
IDENT 



MUX 
EQUIP- 
MENT 
NUMBER 



12 



12 



NOT 



USED 



__ Equipment number of MUX assigned 
This field used in ENTRY only. 

Site address of logged in terminal. 

Set by I/O driver (1ED) to communicate with EXEC (1LS). 



These are defined in lLS's field length and also in COMSEXP. 

00 - Null function 
02 - Message from terminal 
04 - Print block complete 
06 - Special end read 
10 - Write message complete 
12 - MUX not available 
14 - MUX not operational 
16 - Initialization complete 
20 - Terminal connected 
22 - Printer not ready 
24 - Message read error 
26 - Terminal disconnected 
30 - Operator interrupt 
32 - Read E3, no EOF 
34 - Read E3, with EOF 
36 - Read E2, no EOF 
40 - Read E2, with EOF 
16-8 
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16. 3. 2 Status Table TFS 



12 




12 


18 


18 


CP I/O STATUS 


I/O DRIVE 


INPUT FET 
ADDRESS 


OUTPUT FET 
ADDRESS 






! 

1LS responds to 1ED. 





1LS responds to E200CP. 



Note 



El, E2, E3 are hardware functions set by both the remote card reader 
and printer. They are specified in the appropriate EI200 hardware 
manual. 



CP I/O STATUS 



- Run CP. (output, coded mode) 

1 - Run CP. (input, coded mode) 
2, 3, 4 - not assigned 

5 - Return sequence number 

6 - Output file active 

7 - Input file active 

8 - not .assigned 

9 - Output file suspended 

10 - Read, wait for operator "GO" 

11 - = Read E3, 1 = Read E2 on previous read 



I/O DRIVE 



- Terminal on line 

1 - Terminal logged in 

2 - Interrupt during print transmission 

3 - Interrupt during read transmission 

4 - Wait for storage 

5 - Not assigned 

6 - Execute print control program 

7 - Execute read control program 

8 - Execute write message to terminal screen 
9, 10, 11 - Not assigned 



INPUT FET ADDRESS - Relative CM address of input file FET 
OUTPUT FET ADDRESS - Relative CM address of output file FET 
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16.3.3 MSGB - Message Buffer 

Each message buffer is 4 CM words long. The messages to/from the remote terminals 
are placed in the appropriate message buffer with a 0000 termination byte. 

16. 3.4 LINF — Log-in Information Table (2 words /terminal) 
This table is used by XSP to respond to 1LS. 



42 






18 


DISPLAY CODED USER NUMBER 


ALWAYS = 1 


JOB NAME 


USER INDEX 


STATUS 



24 



24 



12 



STATUS — 





1 
2 
3 



USER INDEX - 



Log -in active 

Log -in complete 

Request PP again (system busy) 

Duplicate User Number 

— > Illegal user number 



16. 3. 5 CPIK - CPU Interlock Table 



12 



12 





INPUT 
ACTIVE 


OUTPUT 
ACTIVE 



E200CP sets the proper byte i when active on a file and zeros the proper byte when it 
detects the CPU drive bit off for the appropriate channel (INPUT or OUTPUT). 

16. 3. 6 DPJT - Drop Job Table 



42 



18 



INTERNAL SYSTEM JOB NAME 



RESPONSE STATUS 



RESPONSE STATUS - 



- Drop active 

1 - Drop completed successfully 

2 - PP not available (system busy) 

3 - Job name not found 

5 - Job found but not dropped 
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16. 3. 7 PWLT - Password Table (same location as DPJT) 

At log-in time, this table is used for the user password instead of JOB DROP. 

16.3.8 FAMT - Family Name Table 

At log-in time, this word is used for the user's family name. 

16.4 EXPORT /IMPORT FET 

The EXPORT /IMPORT FET is created for each terminal logged in. The formats are 
shown in Figure 6-4. 

16. 5 EXPORT SYSTEM CENTRAL PROCESSOR PROGRAM (E200CP) 

The central processor portion of the EXPORT system is used for the processing of data 
to and from the remote site. 

Data being received from the remote site card reader is placed in the line buffer allocated 
to the active terminal by the I/O driver program. Very little processing of the received data 
is performed by the I/O driver itself 1ED. The data is converted to display code and 
written, one card image at a time, into the line buffer. When the I/O driver senses an 
end of message code, the CM line buffer is marked full so that E200CP will process that 
data at the next opportunity. Trailing blank suppression and detection of end-of-record 
and end-of-file is accomplished by E200CP. Transmission of data to the system 
allocatable mass storage device is also requested by the E200CP. 

The buffer space for an output file is allocated by the executive program 1LS. The banner 
page data is placed in the circular buffer by the executive program 1LS. All subsequent 
I/O requests are issued by the E200CP program. Data from the circular buffer is com- 
pressed according to the 200 User Terminal specification and placed into the line buffer 
for transmission to the terminal. As much data as possible is placed in the line buffer on 
each cycle. A full line buffer is not always possible to generate because the print line 
cannot be split between messages. 

The control for the CP program is a switched circular scan of the terminal control table. 
Switching is performed by the executive via the status word in the function/ status table. 
Control interlock is through the CPIK table within CM. Every complete scan will attempt 
to complete an entire operation on every active terminal. When an entire scan is com- 
pleted, the CP is place stopped — to be restarted by the executive (i. e. , E200CP goes into 
auto -recall). 
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INPUT FET 



FET -K) 
1 
2 
3 

4 

5 
6 
7 



Internal System Name 


Code /Status 




First 




In 




Out 


FNT Address 








Limit 


Full /Empty 
Driver Flag 


Job Card Proc- 
essing in Prog- 


Address of 
Line Following 

•FOR 


Address of Line 
Following EOF 


Job Sequence Number 





Pointer to Next 
Allocated FET 


Job Priority 


Job Time Limit 


Job FL 





Card Count 



OUTPUT FET 



FET +0 

1 

2 

3 

4 



Internal System Name 


Code /Status 




01 


First 





In 





Out 


FNT Address 


Day File 

First 

Tract 


Day File 

First 

Sector 





Limit 


Full /Empty 
Driver Flag 





Job Sequence Number 





Pointer to Next 
Allocated FET 


Print Line Count 



Figure 6-4. EXPORT INPUT/OUTPUT FETS 
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The eight common decks used by E200CP are loaded in the control table section. They are 
listed in Table 18-2. 

TABLE 16-2. E200CP COMMON DECKS 



Title 


Description 


COMCCIO 


I/O function processor 


COMCRDC 


Read coded line, "C" format 


COMCWTH 


Write coded line, "H" format 


COMCSYS 


Process system request 


COMCRDW 


Read words to working buffer 


COMCWTW 


Write words from working buffer 


COMCMAC 


CPU system macros 


COMCCPM 


Control point manager processor 



Figure 16-5 is a flowchart of the main scanner control. 



16. 5. 1 INP - Input Data Processor 

The following functions are performed by this program: 

1. Move data from the line buffer into the file circular buffer, removing 
trailing blanks in the process. 

2. Write data to the system mass storage device using CIO and standard 
I/O techniques. 

3. Sense and process end-of -records. An EOR is indicated by a block 

of eight words in the line buffer containing the character K- EOR (=30B) 
(defined in COMSEXP) (12-bit field) in byte zero of block word zero. 
Issue a CIO request to write EOR from the buffer. If the first word 
of the next block does not contain EOM (=00B, end of message) (see 
step 5), set the beginning address of the next block in FET+5, 
bits 18-35, and continue processing when the FET becomes free. 

4. Sense and process end-of -file. An EOF is indicated by a block of 
eight words in the line buffer containing the character K- EOF (=27B) 
in byte zero of block word zero. If the word following this eight- 
word block does not contain an EOM code (=0 end of message) (see 
step 5), record the beginning address of the next unprocessed data 
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Read Next 
Status 

Word 




-» 
Input 
Interlock 
CPIK 



0-> 

Output 
Interlock 
CPIK 




Advance 
Scan 

Index 



Yes 




Jump To 
\HP 

Yes 



MP 




%)u*v*p 7* 



Yes 




#2 



OUT 



Yes 




#1 INP described paragraph 16. 5. 1 
#2 Out described paragraph 16. 5. 2 



Figure 16-5. E200CP - Control Scanner 
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Clear He- 

call Bit 

in DRCL 



RECALL 



DRCL 



-»-w 



Restore 
1LS Input 
Register 
at EXCL 



*1 



/ScanN 



/ RECALL 

\ W- INT 
\ / 



Count Num- 
ber of 

Scans in 
W-TNS 





.c Li auto .recall unit DRCL bit 
*2Use system RA+1 request TLX to call 1LS. 
*3See description of TLX request Section 6 (SEP) 
*4Auto recall unit 1LS set W- INT non-zero. 



is sex non-zero oy iinij. 



Figure 16-5. E200CP - Control Scanner (Continued) 
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block in FET+5, bits 0-17, set byte one non-zero, and do not alter 
byte zero (full/empty control). The CP program will wait for FET+5, 
byte one to be set back to zero by 1LS when it has processed the input 
file. Processing of data will then continue at the block address stored 
in FET+5, bits 0-17. 

5. Sense and process end-of -message. An EOM is indicated by byte zero 
of a block (or special last word) containing the character K- EOM (=0) in 
byte zero. The full/empty status (byte zero) of FET+5 is set empty and 
normal data processing continues. 

These special values are ; 

K- EOR = 0030B 
K- EOF = 0027B 
K- EOM = 0000B 
K- EOI = 0055B 

They are specified in the COMSEXP common deck. 

16. 5. 2 OUT - Output File Processor 

Data from the circular buffer is placed into the line buffer by this phase of the E200CP 
program. 

Strings of blanks greater than two characters in length and up to MAXB characters are 
replaced by a two-character compression set. Strings greater than the maximum length • 
are processed as one or more strings of maximum length and a remaining short string if 
necessary. End-of-line codes are placed on every line sent to the remote printer. Only 
complete lines will be placed in the line buffer and lines of more than 136 characters will 
be treated as more than one line, but some characters may be lost from lines of ex- 
cessive length. 

An attempt is always made to fill the line buffer with the maximum number of characters 
allowed. A restriction of the terminal hardware forces a full line to be transmitted before 
an end-of-message. This means that not all transmissions will be maximum length. 

The 200 user terminal has three buffers, the screen, card reader and printer. The screen 
buffer is used for transmission to the MUX consequently card images are transferred from 
the card reader buffer to the screen buffer for transmission to the MUX. Similarly, out- 
put is transmitted by the MUX to the screen buffer, and is then transferred to the printer 
buffer for printing. 
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16. 6 1LS - EXPORT EXECUTIVE ROUTINE 

E200CP will wait in auto-recall until 1ED sets RA+DRCL to 1, indicating some input was 
received from some remote terminal. E200CP will call 1LS to a PP and go into auto- 
recall until 1LS is ready for E200CP to begin processing the input or output. 

1LS may load any of the following overlays at anytime, depending on the action required. 

1. Initial load — 1LS (loaded by system) loads executive subroutines at 7000B. 
These two segments are expected to be resident at all times (1LS and OVRS 
in core). 

2. Function processing — The function processor segment is loaded if any out- 
standing functions from the driver are found (1LS, OVRS, and OVFP in core). 

3. Input file processing -The enter queue segment is loaded if function proc- 
essing found any outstanding input activity (1LS, OVRS, OVPJ, and possibly 
2TJ in core). 

4. Search for and initiate output — The FNT search segment is loaded if the 
time interval for FNT search is satisfied (1LS, OVRS, OVFA and possibly 
2LD in core). 

5. Storage management — The storage manager is loaded if the time interval 
for buffer check is satisfied (1LS, OVRS and OVCS in core). 

Any number of the preceding actions could occur during an executive pass. 

The EST entry is expected to be type 3000 equipment type ST. Change MUXDT EQU in the 
I/O driver if a different equipment type code is desired. 

The EST entry is located by the MUX I/O driver program. The search will find the first 
entry of the proper type which is not set off or assigned to another control point. The EST 
format is as follows: 



7 


5 


6 


6 


6 


6 


12 


3 


3 


6 





CP 

number 





channel 
number 








Device type 





EQ 

num 






All of the normally used EXECUTIVE overlays are stored in central memory within the 
field length of the EXPORT program during initialization. This technique was selected to 
increase the load speed of the PP EXECUTIVE without using large amounts of CMR 
space if EXPORT is not loaded. For this reason, the programs and overlays associated 
with EXPORT should be disk resident. The only part of EXPORT that must be CM -resident 
is the short executive main program, 1LS. 
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The local RPL map is identical in format with the SYSTEM RPL. Starting at the address 
in pointer word P* RPG, a zero word ends the library. 

The routines in the library are: 

1. 9IA overlay OVFP - function processor, when 1ED talks to 1LS via the 
TFS table. 

2. 9IB overlay OVFA - file name table search for print files. It searches 
the FNT for files to be printed at the remote sites. If any such files are 
found, a buffer is allocated and the header information is placed in the 
buffer for the initial print operations. Subsequent data handling is per- 
formed by the central processor program associated with this system. 

It calls overlay 2LD to generate the banner page. 

3. 9IC overlay OVPJ - job card processor. It is called by executive main 
control when needed to process job cards read from the remote terminals and 
enter complete job files into the input queue. It calls system program, 

2TJ, to process the job card. 

4. 9ID overlay OVCS — central memory manager. The storage manager 
executes every few seconds in an attempt to reduce the amount of storage 
used by EXPORT central memory. 

5. 9IE overlay OVIN - initialize EXPORT. The first time 1LS is called by 
E200CP, this overlay will initialize all of EXPORT. 

6. 9IF overlay OVAB - abort EXPORT. All error modes, operator STOP, and 
error messages are processed by this overlay. 

7. 9IG - overlay OVRO - initialize local RPL. Initialize resident library 
programs in control point FL area. Programs are stored in the same 
format as RPL system programs. Pointer P- RPG holds the address 
where this library begins. 

8. 9IH - overlay OVRS — resident subroutines. The subroutines are used by 
the main segment and are loaded into the upper portion of PP memory to 
allow for expansion of the main segment or any other overlay. 

In addition, the two system overlays, 2TJ and 3BB (from BATCHIO), are used. Also, 
fLS will call the following system programs: 
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1. ODF - Drop files 

2. 1AJ — job advancer 

3. 1DL — Display overlay loader 

4. CIO - Combined I/O 

5. XSP - EXPORT service processor 

Figure 16-6 shows the ILS core layout.. Figures 16-7 and I6-S are flowcharts of the ILS 
main flow. 

16. 7 EXPORT SERVICE PROCESSOR (XSP) 

This program is called by the EXPORT executive (ILS) to assist in certain functions that 
require more time or space than are available for individual processing tasks within the 
executive. 

The following functions are available: 

DJP 

VUN 
MJE 



16. 7. 1 Process Job Drop Requests (DJP). 

18 6 12 12 

IR= 



12 



XSP 



CF# 



Index into 
DPJT Table 



Function Code 
for V- DPJT = 1 



The job name table within the EXPORT CM table area is used for job dropping. At the 
completion or abortive attempt to drop a job (a user job at a remote terminal), the return 
status (DPJT + index) is set as follows: 

1 — if job dropped 

3 — if job not located 

5 — if job is located but not dropped 

DJP will get the job name from the DPJT + index, will attempt to locate the job in either 
the system input/output queues or at a control point, and attempt to drop it. If the job 
type is not EIOT, no action is taken. 
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0000 



PPFW 
1312 



1710 
2000 

2401 
3217 



5432 
6000 



6547 
7000 



1LS, EMC 
E200 EXEC 



9IA - function processor 

9ID — central memory 
manager 

9IE - initialize EXPORT 



1100 



9IG — initialize local 
RPL 



9IB — search output 
queue 

9IC — process next job 
card 



9IF - abort EXPORT 



9IH — resident subroutine 



Figure 16-6. 1LS Core Layout 
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Process job card and enters complete job 
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remote sites. If such files are found, a 
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serted for initial print operations. Sub- 
sequent data handling is performed by 
E200CP. 
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Figure 16-7. 1LS - EXPORT Executive Alain Control 
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Overlays 
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Figure 16-8. Function Table Processor 
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16. 7. 2 Log-In Terminal ( VUN). 



12 



12 



IR 



XSP 



CPf 



Index into 
LINF Table 



Function Code 
for V-CUN=2 



If more than one family is being used in this system, IR+3 will also be the index to the 
FAM + table to establish the correct validation table. The common deck, COMSACC, is 
used to search the validation file for the user number, and, if the password given matches 
the one in the validation file, the user index is placed in the response word (LINF + index + 
1). If the user number or password is invalid, the user index is set to 0. 

The format of the request word (offset by index) is: 



LIXF = 


Seven Character User Number 





PWLT- 


Password 





FAMT = 


Family Name 



The format of the response word (offset by index) is: 
24 24 



12 



Generated User Code (GUC) 


User Index 


R 



GUC is used by EI200 to uniquely identify terminal entries. 

1 user logged in 
R = 

3 user was already logged in 



16. 7. 3 Make Initial Job File Entry (MJE) 

18 6 6 18 



12 



XSP 


CP# 





Relative Address of 

INPUT FET 


Function Code 
for V-MJE=3 



FET+7 has the job priorities necessary. This routine will enter the job INPUT file (job 
into input queue) into the system FNT/FST. 

If successful, the FNT/FST entry is created, the system sector is written, the FNT 
address is entered into FET +4, and the status in FET+0 is set to 15 (write complete). 

Figure 16-9 is a flowchart of the entry to process the function code. The routines used 
are : 

OAV — Validate user 
OBF - Begin file 
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The local routine, DRJ, is used to drop jobs after DJP finds them. 




abort job 
drop job request 
log in terminal 
job initiation 



* 1 get priority of the CP program that called XSP and see if its priority matches the 

priority of EI200. 

* 2 is function code legal 



Figure 16-9. XSP - Main Entry 
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16.8 MULTIPLEXER DRIVER (1ED) 

The multiplexer driver program is a dedicated PP program designed to drive one 6671 
MUX connected with up to sixteen 200 User Terminals or other devices with similar inter- 
face characteristics. The designed line rate is 2400 baud. 

This program is initially loaded by the EXPORT subsystem executive and is controlled by 
that executive. The driver will periodically check the system storage move flag and, if 
necessary, issue a pause function to the monitor. During storage'move, no references to 
central memory are allowed. Activity with the terminals is not disrupted in most cases of 
storage move because of internal buffering in the driver. If a drop of the EXPORT sub- 
system is necessary (either because of an operator stop or subsystem malfunction), the 
executive must set the stop bit in status word zero to cause the I/O driver to release the 
channel, its reserved equipment, and stop. External to internal codes and vice versa are 
done via conversion tables. 

There are nine major divisions within the driver program. 

1. Control driver 

Used to time the I/O cycles to the MUX. 

2. Input /output with MUX 

Performs the actual input/output with the MUX when directed by the 
control driver. 

3. Control switch 

Directs the specific activity for each multiplexer port, initiates new activity 
as directed by the EXEC, and keeps each re-entrant driver active. 

4. Poll to connect MUX line 

Probes each active line with all addresses searching for a response. 
When a response is sensed, the EXEC 1LS is informed. 

5. Write message to display 

When directed by the EXEC 1LS, this section is activated to send one 
message from the MSG buffer to the remote display screen. 

6. Print on remote printer 

When directed by the EXEC, this section is activated to transmit one 
buffer block to the remote printer. The EXEC 1LS is informed at the 
end of each block so that end of output processing or remote operator 
directives can be processed if necessary. 
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7. Read cards from remote card reader 

One block of cards is read from the terminal and the appropriate 
function is issued to the EXEC 1LS to inform it if more cards, last 
block, bad codes, etc. 

8. Read operator's messages 

This, along with sense terminal condition is used to process input 
messages from the remote device. The messages are placed in the 
terminal message buffer for translation by E200CP. Any action re- 
quired by an operator message is initiated from the EXEC 1 LS. 

9. Sense terminal condition 

When a connected terminal is otherwise inactive, it is periodically 
checked for messages originating from the remote terminal or other 
action required by the remote terminal when not active. 

Figure 16-10 shows the 6671 multiplexer port data words. Figure 16-11 is a flowchart 
of the 1ED main loop. 
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6671 INPUT WORD 



1 1 



10 





1 
i 












' Character Reject 








— — Carrier On 






—Lost Data 




1 V£ 


i lid 


Characte 


jr 







6671 OUTPUT WORD 



11 8 


7 


I/O Control 


8 -Bit Data Character 



Figure 16-10. 6671 Port Data Word 
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IEM 



3tart\ 



3 Ml 



Read CH 
Clock & 
Set Start 
Time 



14 





Control driver 
(cycle timer) 



lVC~ 



Advance 
Millisecond, 
Count 




Read CH 
Clock & 
Set Cycle 
Time 




Initialize routine. Locate a 6671 which is on and free in the EST, insure that it exists 
and works. If okay, assign channel and modify I/O instructions to use this channel. If 
not okay, issue error message and drop EI200. 



Figure 16-11. IEM- 1ED Main Loop 
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Activate 
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Send 
OUTPUT 




Disconnect 
Channel 



Function 

MUX for 

INPUT 




(cut) 



/Activate / 
Channel / 



Activate 
Channel 

z / 





Get 

Character 
from INPUT 
Buffer 




* 1 RA+DRCL word in E200CP. If no input from MUX, E200CP will go into auto call. 
*2 Set RA+DRCL word = 1, so E200CP will be taken out of recall. 
*3 Drop PP and release MUX channel, and load 1LS to terminate EI200. 
Figure 16-11. IEM - 1ED Main Loop (Continued) 
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Figure 16-11. IEM - 1ED Main Loop (Continued) 
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BATCHIO 17 



17. INTRODUCTION 

The BATCHIO subsystem coordinates communication between the unit record equipment 
(card reader — CR, card punch — CP, and printer — PR) and the operating system. BATCHIO 
basically performs the following four functions. 

• Reads cards from the card reader, creates the input file, and 
enters the job into the input queue. 

• Locates jobs in the print queue, locates a free printer, and prints 
the file on this printer. 

• Locates jobs in the punch queue, locates a free card punch, and 
punches the file on this card punch. 

• Processes the DSD commands ENDxx, REPEATxx, SUPPRESSxx, 
RERUN (rerun, nn), on the specified file currently being operated 
on at the specified buffer point. Buffer point is the term used to 
associate BATCHIO logical devices with the respective hardware 
device. Each device is entered into the available equipment table, 
TAEQ. The index to each entry is the buffer point number. That is, 
the first entry is buffer point 1, the second entry is buffer point 2, 

the last device is n. Hence, the DSD command is END1 or END2, etc. 

NOTE 
BATCHIO (I) display details are explained in Section 4 of the Operator's Guide. 

17. 1 SUBSYSTEM CONFIGURATION 

The subsystem consists of three PP programs and one control point (Figure 17-1). 
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BATCHIO 




C"D 



BATCHIO CP Idle 
FL = 100B, No PPs 




110 is recalled (RCLW word in CPA) 
and begins scan of available unit 
record equipment. 



© 



BUFFER 




110 finds a CR ready and 
calls 1CD for processing. 




1CD calls 1BA to build an input queue 
entry and read the sector to the disk. 




1CD reads the CR in a buffer and 
calls CIO to write the buffer to 
the disk. 



© 



FNT 



FST 




JOBNAME 


BAT 
CHIO 


I 


CP=0 


ID 


EQ 






110 finds an output queue entry and 
calls 1CD (or a punch queue entry). 



Figure 17-1. BATCHIO Overview 
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1CD calls 1BA to create a banner page 
and reads the 1st sector of data from 
the disk to a buffer. 




1CD reads the rest of the file to the CM 
buffer and prints the data on the printer. 





BATCHIO 



1CD completes and drops, 
BATCHIO is now idle. 



Figure 17-1. BATCHIO Overview (Continued) 
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17. 1. 1 Control Point 

The control point memory contains no "code. The first 100B words are used as a communi- 
cation area for the three PP routines, and the rest of the central memory (CM) is used for 
buffer point area, FETs, and buffers. The CM is allocated and deallocated (expanded and 
contracted) as the need arises. The need arises whenever a device or a BATCHIO type 
queue (OUTPUT, PUNCH) needs servicing. Each activated device will be assigned one 
FET and one buffer. Each active device uses a 6-word FET, and each card reader or 
printer uses a 1002B word buffer, while each card punch uses a 402B word buffer. Figure 
17-2 is a diagram of the core layout. 



RA+ 




EA + 1 


( 


RA + 7 


RA + 10 




RA + 11 




RA + 17 




RA + 20 


( 


RA + 27 


RA + 30 




RA + (BUFR) 



DCW - driver control words (1C1) 



DRQR — Driver request word 



TEQR — Available equipment table 



FETs + buffers 



Note further that in the idle 
state BATCHIO has only 100B 
words of CM, and only the first 
30 are of importance. The re- 
maining words are just residue 
of preceding operations. CM 
can only be allocated in incre- 
ments of 100B words. 



Figure 17-2. BATCHIO Central Memory Area 

17. 1. 2 BATCHIO Manager 

1IO is the BATCHIO CM manager, allocating and deallocating core as devices go active 
and become idle. In addition, this routine scans the card readers and the OUTPUT and 
PUNCH queues, and starts up the drivers in 1CD. 

17. 1. 3 Combined Driver 

1CD is the combined driver for these three devices. 1CD will call CIO to read and write 
on mass storage (MS) and 1BA for certain auxiliary functions. 
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17.1.4 Auxiliary Processor 

1BA is the auxiliary processor. It performs processes which would be difficult or im- 
possible to perform in 1CD. 

NOTE 

All three routines use the common deck COMSBIO for table and communi- 
cation area specifications {see Section 20). 

17. 1. 5 Central Memory Area 

Figure 17-2 illustrates the BATCHIO central memory area. Specific areas of concern 
are described subsequently. 

17. 1. 5. 1 RA + and RA + 1 always remain zero. 

17, 1, 5, 2 RA + 1 through RA + 7, DCW are used by HO to determine how many copies of 
1CD are active and how many requests each one is currently processing. They are 
allocated backward. That is, the first time HO assigns a copy of 1CD, it will set up 
RA + 1. Then HO can assign up to MEQD (currently 10) requests to this 1CD. When 
this 1CD is working on MEQD requests, it is necessary for HO to assign another copy 
of 1CD. HO will therefore set RA + 2, etc. 



DCW = means a corresponding copy of 1CD is not active 
18 6 12 



if active, 
DCW = 



24 



12 



1 C D 





DCW offset 


current number 
of requests 






17. 1. 5. 3 RA + 10, DRQR is used by HO to give 1CD a request. 

12 12 12 24 

DRQR = 



DCW offset 


EST ord. 


Buffer point 
Number 


Buffer FWA 



DCW offset, RA + DCW offset gives this lCDs DCW. That is, if DCW offset is 
7 (first 1CD called), then RA + 7 is the DCW for this 1CD. If DCW offset is 2 
(6th and maximum 1CD call), then RA ■*• 2 is the DCW for this 1CD, 

EST ordinal is the ordinal of the device which 1CD must drive. 
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Buffer number and FWA. The buffers in BATCHIO's field length are allocated in the 
order desired. If a buffer becomes available, this device will be assigned to this 
buffer number, otherwise 110 will allocate more fl and increment the buffer count. 
The buffer number field is just the sequential number of this buffer. Buffers are 
threaded via the LIMIT field so that 1CD can count its way to the correct buffer. 
Buffer FWA is actually the FWA of the FET for this buffer number. 

17.1.5.4 RA + 20 through RA + 27 TEQR is an exact copy of the TAEQ table (Figure 17-8) 
built by HO during preset. Every time 110 is recalled, it restores the TAEQ table (50B PP 
bytes) by reading the TEQR (10B CM words) into the TAEQ table in its PP memory. (If the 
status of a unit record equipment is changed (other than OFF when the unit was on) it is not 
taken into account, and BATCHIO will have to be dropped and recalled to include this 
equipment.) 

17.1.5.5 RA + 30 BUFR points to the first FET of the buffer. 

DSD communicates with 1CD for the commands END, REPEAT, SUPPRESS, RERUN, etc. via 
the control point area (Figure 17-3). 

CPA + BFCW points to the first buffer point number. 

CPA + BFCWL is the buffer point area. 

CPA + BFCW general Format 2 word entry. 















. 


6 


6 


6 


Jobname 


repeat 
count 


Code 

0,1, 2, 3, etc 


No, of times pru 
files to SKIP 












S 











10 no suppress 

11 suppress 

DSD COMMANDS for BATCHIO 

1 - ENDn. 4 - STOPn. 

2 - RERUNn. 5 - CONTINUEn. 
none - REPEATn. 6 - BKSPRUn,y. 

3 - SUPPRESSn. 7 - BKSPn,y. 



10 - BKSPFn,y. 

11 - SKIPRUn,y. 

12 - SKTPn,y. 

13 - SKIPFn,y. 
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Figure 17-3. Control Point Area 
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See Section 7 of the KRONOS 2. 1 Reference Manual for more detail. Note that LIMIT - LWA 
of buffer = FWA-1 of next FET. Hence, when one knows BUFR, and what the buffer number 
is (not buffer point number) one can easily thread one's way via the LIMIT field to any buffer 
desired. Also note that FET + 4 and FET + 5 is used by BATCHIO somewhat differently 
than in a standard FET (that is, 1CD can modify these calls for its own purposes between 
calls to CIO. 

17.2 SUBSYSTEM OPERATION 

HO is a transient PP routine. It recalls itself by always copying its IR into the control point 
recall register, RLPW, before dropping. 

HO will scan through the TAEQ table processing any device it finds in the ready status. 
When it has completed one scan, it will recall itself. 

When 1IO finds a card reader in ready status, it will initiate a request in DRQR for 1CD to 
read the card reader. If 1CD must be called, 1IO will recall itself and call 1CD into its 
PP. If 1CD does not need to be called, it will continue scanning the TAEQ. 

When 1IO finds a printer or a card punch in ready status, it will search the FNT for un- 
assigned files in the respective queue (OUTPUT or PUNCH). If the search is fruitless, HO 
will continue its scan of the TAEQ* It is assumed that a job will enter the queues"at any 
time, and this method will assign the output device pointed to by the current TAEQ index. If 
the search is successful, 1IO will initiate a request for 1CD. 

1CD will check the DRQR for a proper request (see 17.4) and, if so, will load the proper 
driver. 1CD contains drivers for all unit record equipments. It also checks the buffer 
point word for operator requests. If there is a request for this 1CD for a card reader, 
the following occurs: 

1. 1CD will read one buffer of cards (1000B CM words) and call 1BA to crack the 
job (1BA calls 2TJ) card (first card in the buffer), set up an FNT/FST entry 
of type "INPT" (place job in input queue), and via CIO write this buffer onto 
MS in FET + 5. When complete, ISA will set the FET status completion bit. 

2. 1CD will then read the card reader and transfer the card images to this file 
created by 1BA via CIO. 

3. After the last buffer is transmitted (EOI on card reader) the card reader will 
be released. 

If the request was for a printer, the following occurs: 

1. 1CD will call 1BA to create the banner page and place it into the first 20B 
words of the buffer and indicate completion in the buffer status word, FET + 5. 

2. 1CD will then transfer data from the output file into the buffer via CIO and 
prints the file onto the printer in the proper format. 
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3. When CIO indicates an EOI status in the buffer, 1CD will call 1BA to place the 
job accounting information in the buffer. 

4. ICD will complete the printing of this last buffer, release the output file, and 
release this printer. 

5. 1IO may deallocate the buffer if there are no more files to print or get a new 
job from the output queue and request ICD again. 

If the request was for a card punch, the following occurs: 

1. ICD will call 1BA to create the header card, place it into the buffer, and 
indicate completion in the buffer status , FET + 5 . 

2. ICD will then transfer data from the file into the buffer via CIO, and then 
punch the cards. 

3. When CIO indicates an EOI status in the buffer, ICD will punch the last set of 
cards, release the punch file and release the CP. 

4. Same as for printer (step 5) . 

Figure 17-5 is a diagram of the idle state. 1IO will pop in and out of a PP to check the out- 
put queue and the status of all card readers. TAEjQ, a* table of available unit-record equip- 
xn«it accessible by BATCHIO, joints to the EST en|:ry of each device. 
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Figure 17-5. BATCHIO Idle State 
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Figure 17-6 is a diagram of the active state. 110 reads the TAEQ and the output queues, 
and builds a request for 1CD in DRQR. 1CD calls CIO and 1BA, which call CIO, etc. 
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Figure 17-6. BATCHIO Active State 
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17. 3 B.ATCHIO MANAGER - HO 

1IO is the executive routine for the BATCHIO subsystem, and performs scheduling of ail 

processes operating at the BATOHIO control point. These include: 

1. Searching for the highest priority OUTPUT and PUNCH files. 

2. Checking for a ready status on any CRs. 

3. Managing of buffer storage and allocating and deallocating CM for the BATCHIO 
control points 

4. Posting of error condition messages for any of the above. 

NOTE 

LOAD jobs from tape and DUMP output file to tape is processed by 
DMQ and LDQ, and not by BATCHIO. 

17. 3. 1 The 1IO call is shown in Figure 17-7. 

IR = 

where: 

p = (0 Preset has not been called (1st time called by IDS) 

(1 Preset has been performed (subsequent calls via the control point recall 
register RLPW) 

cp = Control point number 

a, b, c = when first called by IDS 

Figure 17-7. 1TO Call 

As HO operates, it stores values in these cells (IR+2, 3,4), and when recalled IR+2, 3,4 are 
reset. On recall: 

a = IR+2 = scratch direct cell 

b = IR+3 = TAEQ index 

c = IR+4 = number of buffers allocated = number of requests currently performing. 

HO uses the overlay 3IB to load 3555/512, 595-1 image memory into the 512 if needed. 

1IO uses the overlay 3IA for all its subroutines and calls 1CD which is the BATCHIO device 
driver. 
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TABLE 17-1. DIRECT LOCATION ASSIGNMENTS 



FWA 


Code 


Value 


Location Assignments 


20 


FS 


20 - 24 


FST entry (5 locations) 


25 


BA 


25 - 26 


Buffer address (2 locations) 


30 


ES 


30 - 34 


EST entry (5 locations) 


135 


ST 


35 


Equipment status 


36 


EQ 


36 


Equipment number 


40 


CN 


40 - 44 


CM word buffer (5 locations) 


57 


FA 


57 


Address of FST entry 






Assembly 


Constant 


12 


CH 


12 


Channel number* 



*Note that channel 12 appears to be hardwired. This is not the case since HO and 
1CD will modify all I/O instructions to use the proper channel, via COMPCHI 
(see Section 20). 



When the operator command n. IO, AUTO, or MAINTENANCE is sensed, DSD will call IDS, 
which will assign a high number control point (usually n-1) and call 1IO. 

HO will check the p bit in its IR, and since p = 0, it will enter .the preset segment. 



job name = BATCHIO 





CPU pri- 
ority* 1 


queue 
priority 
i "BIPS" 





Time 
Limit 






17. 3. 2 Preset will perform the following functions. 

1. Store the 5 bytes starting at PRSA into the control point area (CPA) JNMW. 

2. Store the 5 bytes starting at PRSB into the CPA JCIW. 

PRSA = JNMW = 
PRSB = JCIW = 



3. Create the TAEQ available equipment table and copy it to TEQR to enable reloading 
it for subsequent recalls of HO. TAEQ is created by comparing Table 17-2 of 
equipments, TEQT, to the equipment mnemonics in the EST. 

As an equipment is found in the EST which corresponds to any equipment in this table, the 
TAEQ entry is made. If a device in the EST has an incorrect channel or unit assignment, 
is turned off, or is rejecting, HO will issue one of the following messages: 

• EQXX, CHYY. RESERVED. TURNED OFF. 

• EQXX, CHYY, NO. 6681. TURNED OFF. 

• EQXX. CHYY, REJECT. TURNED OFF. 
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TABLE 17-2. TEQT TABLE 





12 bits 


TEQT + 


display code LP 


+ 1 





■f 2 


display code LQ 


+ 3 





+ 4 


display code CP 


+ 5 


1 


~ 6 


display code CR 


+ 7 


2 



Each entry in the TAEQ corresponds to the buffer point number. Refer to "I" Display, 
Section 4 of the KRONOS 2. 1 Operator's Guide. 

The format for the TAEQ table is shown in Figure 17-8. 



TAEQ + 
+ 1 

+ 3 



+ SOB 



6 bits 



ts 



Number of Entries in This Table 



EST ordinal for 
1st eq 



EST ordinal for 
2nd eq 



It it exists, EST 
ordinal for 47B eq 



eqtype 



eq type 



eq type 



Buffer point 1 
Buffer point 2 



Buffer point 47B 
two bytes /entry 



EQ TYPE = ( printer 

( 1 card punch 
( 2 card reader 



Figure 17-8. TAEQ Table Format 



The final function of Preset is to set P=l in the IR, so that subsequent recalls of 1IO will not 
cause preset to run, but will cause TAEQ to be loaded from TEQR in the control point mem- 
ory. 



97404700B 



17-13 



17. 3. 3 One cycle of HO consists of scanning through TAEQ, and either the scan completes 
or a request to 1CD is made. When one cycle completes, HO will recall itself and drop. 

When HO has a request for 1CD it checks DRQR. If DRQR is nonzero (that is, some copy 
of 1CD has not yet responded to the last request) HO will process error messages, and check 
central memory allocations. Eventually, DRQR will go to zero. It has been shown that the 
frequency of requests versus the speed of unit record equipment, versus the speed of 1CD 
responding, does not necessitate more than a one-word request stack. The time lost while 
HO waits for DRQR to clear is negligible. 

When DRQR is zero, HO will check the DCW words for an active 1CD. If one is found and 
byte 2 (number of current requests active) is less than MEQD, HO will set up the request 
in DRQR. Note that up to six copies of 1CD may be active at one time (depending on MXEQ, 
which is an assembled constant in HO and states the maximum number of equipments that 
can be active at once. Currently MXEQ = 24B so the maximum 1CD copies is three). 

If there are no copies of 1CD currently active, or the copies which are active have the maxi- 
mum current requests MEQD, and this request brings the total current request to less than 
MXEQ, then 1IO will set up the next DCW word, set up the DRQR word, recall itself, and 
call 1CD into this PP. 

When 1IO is recalled, it will check if the operator desires to drop BATCHIO. If this dis- 
able bit has been set (bit 47 in SSTL in CMR), 1IO will not schedule any new 1CD requests. 
It will wait until all pending requests are complete, process any error messages as they 
occur, release buffers and all of central memory assigned to the control point, release the 
control point, and then drop from the PP. If the disable bit is not set, 1IO continues its 
scan at TAEQ + (IR+3) (Figure 17-9). 

Figure 17-10 is a flowchart of the main loop routine and Figure 17-11 is a flowchart of the 
preset routines. 

NOTE 

When 1IO requests 1CD to work on a file in the OUTPUT or PUNCH 
queues, 1IO will set the CP assigned number field in the FNT to 
BATCHIO 's control point number. This effectively removes the file 
from the queue so that 1IO will not consider this file again. When 1CD 
is done and releases the file, the FNT will also be eliminated. If the 
system crashes and a recovery deadstart is performed, the recovery 
will attempt to find all files whose FNT queue type is INPUT, OUT- 
PUT, or PUNCH, and will set the CP assigned number back to 0. 
Therefore, 1IO can find them when BATCHIO is activated. 
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0000 



2074 

2104 

3331 
4124 
4623 
7000 



PP resident 



HO 



3IA - 1IO subroutines 



COMP3XD - 3000 equipment 
driver subroutines 



image character table 



TAEQ - temporary available 
equipment table 



3IB - Load 3555/ 
512 image mem- 
ory used for a 512 
using the 595-1 
train carriage. 



Figure 17-9. HO Core Layout 
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*1 

*2 

*3 
*4 

*5 

* 6 



PROCESSOR 
TABLE 


Name 


Pro- 
cessor 


LPP 


Line 
Printer 


CPP 


Card 
Punch 


CRP 


Card 
Reader 




DPP 



place HO IR 
into the RE- 
CALL register 
RLPW 



RTN 



drop 
PP DPPM 




display code for 1IO 


P 


CP number 



check for P=l 



IR+1 

CMR cell SSTL 

Is IR+4 negative 

Messages are IDLE and xx BUFFERS ACTIVE 

Check RA+DRQR 

RA+TEQR read EST and check each equipment for status in TEQR table; if some equip- 
ment needs to be processed, then (A)^0, (EQ)= equipment number (ES-ES+4)=EST entry, 
(IR+3) = equipment index. 

Figure 17-10. HO - BATCHIO Manager BCM MAIN LOOP 
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Store 

"BATCHIO" 

in 

JNMW 



Store CPU 
queue pri- 
orities in 
JCIW 



_L 



Clear IR flags 

IR+2 = 
IR+3 = 
IR+4 = 



FTN 



request 
^storage RSTM. 



PRESET routine set up central memory at the 
BATCHIO control point 

Entry CP = control point number assigned by 
IDS 



No equipments assigned 
Job origin = system 



ia rvi a 



JNMW = 



BATCHIO 



CPU queue 
priority 



time limit 



JCIW = 



1 


BIPS 





i... 








©■ 




Clear any 

console 
messages 



Clear 

RA thru 

RA+30 



Display 
message 
waiting for 
STORAGJ 



RCL 



PRS 
X 



Figure 17-11. BATCHIO Manager PRS for HO 
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Built Available Equipment Table TEQR 





Read ESTP 
in CMR 


prsY___, 






v3/ 


< ' 




Read next 
EST entry 




Display NOT 
ALL EQUIP- 
MENT SER- 

viceab: 




prs> 



store eq num 
ber and type 
in temporary 
table 




* 1 first time through read 1st est entry 

* 2 is EST entry t 

* 3 stored in high PP memory (see core 

layout) 

* 4 no more than MXEQ buffers can be 

allocated 



Figure 17-11. BATCHIO Manager PRS for HO (Continued) 
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Y 



Build Available Equipment Table - TEQR 



set buffer 
pointers BFCW 
advance table 
pointer 




set preset 
flag in IR+1 
(P=l) 



r 



RETURN 



J 



* 5 "-did we put any equipment into our 
temporary table. 



Figure 17-11. BATCHIO Manager PRS for 1IO (Continued) 
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17.4 BATCHIO COMBINED DRIVER- 1CD 

The BATCHIO driver, 1CD, can drive up to eight devices of three types (any combination). 

These three types of devices are: 

3256/501/505 - 3555/512 Printer 
3446/415 Card Punch 

3447/405 Card Reader 

Some mass storage transfers and other functions, such as accounting are performed by 
calling 1BA. Most mass storage transfers are performed by CIO. 

A multitude of common decks are used. Among them are: 

COMPMAC 

COMSJOT - Job output equivalence 

COMTDBD - Display code to BCD/BCD to Display code 

COMTDP9 - Display code to 029 

COMT9DP - 029 to Display code 

All the COMT common decks are simply tables of display code values for each BCD charac- 
ter. 

17.4. 1 Printer - 3256/501/505 - 3555/512 Driver Characteristics 

Line spacing is normally done in the AUTO EJECT mode. That is, creases in the paper are 
skipped via the 3256 or 3555 automatic line spacing. Thus, it is necessary for AUTO 
EJECT totbe deselected if one wants to use format channels to advance from prior to bot- 
tom of form to beyond top of form. An example of this would be with the typical KRONOS 
format tape which has only one hole in Channel 6 thus providing an eject of up to two pages 
in order to ensure all banner pages correctly. It should also be noted that deselection of 
auto eject mode on a 512 will result in deselection of eight lines /inch if previously selected. 

The first character of the print line controls the optional formats. This character is not 
printed. The print line, therefore, consists of up to 136 characters. The first character 
is not printed if it is recognized as a format control character. 

The format control characters and their functions are listed in Table 17-3. 

Any format control other than "Q", "R", "S", and "T" are processed once for the line 
printed. 
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TABLE 17-3, FORMAT CONTROL CHARACTERS 



Char. 


Function 


C 


Skip to format channel 6 after print 


D 


Skip to format channel 5 after print 


E 


Skip to format channel 4 after print 


F 


Skip to format channel 3 after print 


G 


Skip to format channel 2 after print 


H 


Skip to format channel 1 after print 


Q* 


Suppress auto eject 


R 


Set auto eject 


S 


Clear 8 lines /inch (512 only) 


T 


Set 8 lines /inch (512 only) 





Space 1 line before print 


1 


Eject page before print 


2 


Advance to last line of form before print 


1 3 


Skip to format channel 6 before print 


1 4 


Skip to format channel 5 before print 


i 

5 


Skip to format channel 4 before print 


6 


Skip to format channel 3 before print 


7 


Skip to format channel 2 before print 


8 


Skip to format channel 1 before print 


+ 


Suppress space before print 


- 


Space 2 lines before print 


/ 


Suppress space after print 


Space 


No line control 


Other 


No line control - character printed 



* Q , R , S , and T Ignore the remainder of the line . 
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17.4.2 Card Punch 3445/415 Driver Characteristics 

Hollerith cards are punched from a line consisting of up to 140 characters. However, only the 
first 80 characters of the line are actually punched. The display code to 026 conversion is 
accomplished by a display code to BCD conversion in the driver followed by the hardware BCD 
to Hollerith conversion in the 3446. On the other hand, the display code to 029 conversion is 
accomplished by a display code to binary column images in the driver. These column Images are 
then punched as an absolute binary card. 

Binary data are punched in the following format: 

Column 1 = Word count and binary card indicator (79) 

Column 2 = Binary data checksum modulo 4095 

Column 3 = 77 = 15 central words of data 

Column 78 = Blank 

Columns 79 -80 = 24 -bit binary card sequence number 

Absolute binary data are punched 16 central words/card with no special punches. 

End -of -record cards contain a 7/8/9 punch in column 1 , and the remainder of the card is blank. 

I End -of -file cards contain a 6/7/8/9 punch in column 1 , and the remainder of the card is blank. 

Cards offset are as follows: 

• The blank card which precedes the deck. 

• All end-of -record cards. 

• A card on which a compare error was detected will be offset and also the following card . 
These two cards will be repunched until no error is detected . 

17.4.3 Card Reader 3446/405 Driver Characteristics 

Hollerith cards are read with trailing spaces deleted. Up to 80 characters may be transferred to 

the CM buffer. Hollerith-to-display code translation is accomplished by the Hollerith to BCD 

conversion hardware in the 3447, followed by a BCD to display conversion in the driver. 

Hollerith conversion may be changed by any of the following: 

Card Mode Change Indicator 

Job card "26" or "29" punched in columns 79 & 80 

7/8/9 card "26" or "29" punched in columns 79 & 80 

6/7/9 card "26" or "29" punched in columns 79 & 80 

5/7/9 card no punch in column 2 indicates 026 mode, "9" punch in column 2 indicates 

029 mode 



17 _22 97404700C 



A mode change is in effect until changed. Default keypunch mode for a job is defined as an 
installation parameter. 

For the 5/7/9 card, the following are valid conversion mode punches in column 2: 

Blank 026 

9 029 

4/5/6/7/8/9 Literal input 

Cards are read in binary format with no conversion or checking until a 
card which is identical in all 80 columns is read. 

Binary cards must conform to the above specification for punched binary data. An end -of -record 
consists of a card with 7/8/9 punches in column 1. And end-of-file consists of a card with 
6/7/9 punches in column 1. And end -of -information consists of a card with 6/7/8/9 punches 
in column 1 . The 7/8/9 card and the 6/7/9 card signal input keypunch mode conversion. A 
"26" punched in columns 79 and 80 of either of these cards (or on a job card) indicates that the 
following cards are in 026 mode. A "29" in columns 79 and 80 indicate a change to 029 mode. 
Anything else in columns 79 and 80 will not affect the input mode and will be ignored . 



IR+1 



IR+2 



IR+3 



IR+4 



1 C D 


CP 


DGW Offset 









17.4.4 The ICDcallis: 

m+o 

IR 



The preset routine moves the COMT deck conversion tables which are assembled at the end of 
the code into PP resident at location MSD, since 1CD does not use any mass storage drivers. 
This allows 1CD to use high core for transient tables and data. It presets the control point 
number so it can call 1BA and specify the control point number in ISA's IR. 

After preset (and as long as 1CD is at this PP) , the main loop will check DRQR for nonzero. 
If it is nonzero, the DRQR DCW offset is compared to this 1CD DCW offset in IR+2. If they do 
not match or DRQR was zero , 1CD will assess the status of its active requests . As a request 
goes inactive, 1CD will decrement the active request count in its appropriate DCW word. If 
the active request count goes to zero, 1CD will clear its respective DCW word and drop. 

If the DRQR DCW offset was equal to this 1CD, 1CD will start up the proper driver and 
increment its active request count in its appropriate DCW word. 

17.4.5 After each call to CIO or 1BA, 1CD will jump to its main loop. The drivers can be 
processing many requests simultaneously. They are honored in sequence by 1CD. The limit 
of MEQD (currently 10B) is all one copy of 1CD can process; and, still continue to drive each 
device at top speed. 
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1CD can issue the following two error messages: 

• EQXX, CHYY, FCN ZZ REJECT. = A function reject or transmission parity error was 
detected . 

• EQXX, COMPARE ERROR. = Compare error was detected. 

where: EQ = equipment type (CP, CR, LP, or LQ) 
XX = EST ordinal 
YY = Channel 
ZZ = Function code 

1CD can issue the following operator messages: 

• LPxx. NOT READY. = Printer xx is "not ready." 

• LPxx. NO PAPER. = Printer xx has a paper out condition. 

• CPxx. NOT READY. = Punch xx is "not ready." 

• CRxx. NOT READY. = Reader xx is "not ready . " 

• CRxx. COMPARE ERROR. - RE-READ 1 CARD. = Reader xx has a card compare error. 
Operator should re-read the last card in the output stacker. 

• CRxx. RE -RD 2 CDS. BINARY ERROR. = Reader xx has encountered a binary card on 
which the checksum does not check. In order to recover, the operator must re -read the 
last two cards in the output hopper. 

When DSD senses the request ENDxx, REPEATxx, SUPPRESS, or RERUNxx (Rerun job), it calls 
IDS which will place the request in the BATCHIO buffer point word (BPW) (If BATCfflO is not 
active , these commands are ignored) pointed by BFCW in COMTBIO . BFCW points into the 
BATCHIO control point area which is the control statement buffer. 

1CD will periodically check the BPW. If a request is set, it will see if the buffer is busy 
(that is , data is transferring from buffer to MS or MS to buffer , 1CD must wait for FET status 
completion bit to be set) and the request is ignored but nor cleared. Eventually, 1CD will find 
the buffer complete and will process the request as follows: 

1. END. Set EOI status in buffer, empty buffer. If printer, 1CD gets the last sector 
(dayfile) and prints it, then process normal end for equipment. 

2. REPEAT. If CR, 1CD ignores the request, else advance repeat count by 1. 

3. SUPPRESS. If not PR, 1CD ignores the request, else toggle suppress flag. Yes, this 
means the operator can unsuppress a listing. 

4. RERUN. If CR, 1CD ignores the request, else read FST entry, reset file status, set 

new priority, and clear control point assignment (i.e. , place file back into output queue) . 

All these functions will generate an appropriate dayfile message. Figure 17-12 is a flowchart 
showing the main loop of 1CD. 
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Preset 



Move tables 
to high PP 
core 



*1 



Clear 

buffer printer 






read request 
DRQR 



SEA 



set equipment 
request 





* 1 All the COMTXXX tables are loaded at location MSD (600). 

directly at the end of the code of 1CD„ 

*2 Is the (top byte) = (IR+2), i.e., this PP number. 

* 3 Build table of equipments to check for activity. 



This loop relocates them 



Figure 17-12. BATCHIO Driver - 1CD 
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17. 5 BATCHIO AUXILIARY PROCESSOR - 1BA 

The auxiliary processor 1BA is called by 1CD to process Mast Storage (MS) transfers and 
special functions impossible or inconvenient to perform in 1CD. 1BA uses the following 
routines: 

0BF - Begin file 

2TJ - Translate job card 

Auxiliary processor 1BA consists of five processors, which are discussed subsequently. 

17.5. 1 LPR - Load Initial Print Data, Function 1000 

This routine (entry LPS) loads the banner page for the job which is being printed. The ban- 
ner consists of the file name in formatted characters. At exit, the header page and banner 
page are stored in the buffer starting at FIRST. IN buffer parameter is updated. 

17. 5. 2 LPH - Load Initial Punch Data, Function 2000 

This routine (entry PHD) stores an image of the job name in the buffer. This image is in 
the form of holes which are to be punched on a card to produce a readable deck identifica- 
tion (header card). At exit, the header card consisting of 20B words will be stored in the 
buffer beginning at FIRST. IN will be updated. 

17. 5. 3 ACT - Process Accounting Information, Function 3000 

This routine (entry ACT) will put the accounting information at the end of print buffer. This 
information is: 

"LP XXXXXX.XXXKLN" = Kilo lines printed 

"PC XXXXXX.XXXKCD" = Kilo cards punched 

"CRXXXXXX.XXXKCD" = Kilo cards read 

17. 5. 4 IIF - Initiate Input File, Function 4000 

This routine (entry IIF) will set up the input file and begin to (0BF) build the FNT/FST for 
it set its type = "INPT", etc. It also calls CIO to write the first buffer. This routine is 
called to build an input file consisting of the card images read from the card reader. It 
effectively places the job read from the card reader into the input queue. 

17. 5. 5 BCAX - Subroutine Exit, Function or End-of -Table 

This portion of 1BA is the terminus point of the other four routines. Also, if a function is 
illegal (not in the function table TOPC in IBA's PP memory), it will fall to this point. BCAX 
will set the status complete and exit from the PP. 
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The 1BA call is: 



IR 


IR+1 


IR+2 


IR+3 IR+4 


1 B A 


CP 
number 


n 


FWA of buffer j 



1BA will set the completion bit in the FET (word FET+5) when he is done. 

The core layout for the 1BA overlays is shown in Figure 17-13. 

1CD will set the function code (1000, 2000, 3000, 4000) in the buffer status word in the FET, 



0000 



PPFW = 1100 



1144 



2000 



PP resident 


1BA main loop 


IIF - initiate input file 


3BA 
3BB 
3BC 


- ACT - Accounting 

- LPD - Printer banner | 

- PHD - Punch header card j 



Figure 17-13. 1BA Core Layout 



Figure 17-14 is a flowchart showing the main logic for 1BA. 
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Table of Processors 2 
Function Routine 



1000 


LPR 


2000 


LPH 


3000 


ACT 


4000 


IIF 





BCAX 



LPH and ACT processors return to BCAX 





Set status 
complete 
(BS+4) = 1 



Store buffer 
status in 
FET+ 5 



/ FTN drop 
\ PP DPPM 




PPR 



: 1 Set up (FT - LM+1) = Buffer parameters - FET stuf 
(FA) = Address of FNT entry 

(BS - BS+4) = Buffer status 
(A) = (BSf4) = Function request (1000, 2000, 3000, 4000,0) 

1 2 Table of processors is TOPC 



Figure 17-14. BATCHIO Auxiliary Processor - 1BA 
Main Entry BCA 
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TABLE 17-4. BATCHIO CPA & FL 


Foil 


Address 


Description 


1 


2200-2217 

nnn n 


Exchange package status word RA = 135500 




2221 JNMW 
2225 RLPW 


Name = BATCHIO 

PP Input register, 1TO is in recall. 




2230 MS1W 


Line one message is 2 BUFFERS ACTIVE. 
Note 12 bits of zero indicates end of line 




226 7 CSPW 


FST Input address in 3313 with EOR flag 
set. There are no CC so limit = current = 0. 
The file at 3313 is used by BATCHIO as a 
dummy input file 




2330 CSBW 


This is normally the CC buffer, but since 
BATCHIO never runs in the CPU it is never 
advanced. Hence, this is used to control 
activity at each Buffer Point. 




2330 & 2331 


Buffer Point 1 is the CR. Job MORACYI is j 
being read by CD from the CR. | 




2332 & 2333 


Job DUMPACCXP is being printed by 1CD 
on an LP. 


2 


135500 


Start of FL for BATCHIO RA+1 is used for 
scratch, since BATCHIO is never active in 
the CPU, neither monitor will ever scan 
its RA+1 . 1CD is called by HO via an 
RPPM function. At this time 1CD with 
offset 1 is running. It has an activity 
count of 2. As we saw at 2330 and 2332, 
buffer point 1 and 2 are active. 




135510 


The DRQR is empty so 110 is not communi- 
cating to 1CD at this point. In fact, since 
RPLW is not zero, HO is currently in 
recall. 




135520 


TEQR. There are 2 entries LP at est ord 11 < 

and CR at est ord 20. ! 

j 




1135530 


This is the FET for buffer point 1 . The fn ! 
is DUMPACX. ' 




135531 


FIRST = 36 1 




135532 


IN = 611 j 




135533 


OUT = 777 : 


1 


135534 


LIMIT =1100 which points us to the next j 
buffer 
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TABLE 17-4. BATCHIO CPA & FL (Continued) 


Foil 


Address 


Description 


2 


135535 


Buffer status for 1BA 




135536 


FWA of buffer. This buffer is full and 
extends to 136576. 


3 


136600 


FET for buffer point 2. lfn = JMORACY 




136603 


LIMIT = 2200 which is the LWA of fl. 




136602 & 136603 


IN=OUT=1116=end of useful info in buffer 




136606 


FWA of buffer 




136615 


LWA of buffer. Note that the card stream 
is ended with at least 12 bits of zero. 




136616 


LWA + 1 of useful data all following is 
leftover garbage . 



| 17-30 



97404700C 



-J 

o 



O 



ABSOLUTE DUMP FROM 002200 



TO 



002200 
00*203 
002206 
002211 
00221* 
002217 
002222 
002225 
002210 
002233 
002236 
0022*1 
0022** 
0022*7 
062252 
002253 
002260 
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18.0 INTRODUCTION 

In the course of an execution, a PP routine may want to have some special operations 
performed. Depending on the routines, different areas of core may be available for load- 
ing special routines. 

In order to have the facility to load a PP routine anywhere in core, the concept of Location 
Free Subroutines (LFS) is used. 

Two macro packages COMPREL and COMPRLI provide the capability for a subroutine to 
make itself relocating. 

18. 1 LOCATION-FREE SUBROUTINE-LFS 

By convention, any PP routine, whose name begins with a zero is considered a location- 
free subroutine. A routine which needs an LFS will set LA direct cell 15 to the location 
where the LFS is to reside, and then calls PLL to load it. 

18.1.1 LFS-COMPREL 

There are two ways to code an LFS. The first way is by using COMPREL. The user does 
a *CALL COMPREL, then codes his program. All "M" type instructions will automatic- 
ally have LA inserted in the d field. Hence, the user may not specify a d field in any 
"M" -type instruction. In addition, CRM, CWM, AJM, IJM, FJM, EJM, IAM, and OAM 
cannot be used. If the user wishes to specify an "M"-type instruction without relocation, 
he must append a "." onto the instruction. Such as "LJM." instead of "LJM". Also, 
any "M"-type instruction which references a cell defined in SYSTEXT (PPCOM) will not 
be relocated. If the user wishes to code non-relocatable code after his relocatable code, 
he merely uses the macro RSTR, which is contained in COMPREL. COMPREL relocates 
instructions with reference to LA as they are encountered in the code. 

18.1.2 LFS- COMPRLI 

The second method of coding an LFS is to use COMPRLI which relocates indirectly 

All the rules of COMPREL are the same with the exception that it is legal to relocate I/O 

instructions. In addition, the three "C"-type instructions, LDC, ADC, and LMC are also 

relocatable. 
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Where COMPREL relocates instructions as it encounters them, COMPRLI builds a remote 
table using the RMT pseudo op (see COMPASS Reference Manual) containing the address 
of all instructions that need to be relocated. The first executable statement must be a 
"RJM. REL, LA". The routine REL is contained in COMPRLI REL will search through 
the remote table and relocate all instructions whose addresses are stored in the table. 
Of course, the user must call COMPRLI with an appropriate call statement. (* CALL 
COMPRLI) 

Figures 18-1 through 18-4 are listings of COMPREL, COMPRLI, and the partial listings 
of ODF and OAV which will serve as examples. As a further note, a current listing of 
COMPREL, and COMPRLI can be obtained by assembling CALLPPU as shown in Section 21. 



18.1.3 To Load in LFS 
EXECUTE OAV, OVL 



PP memory 



LA 



OVL 



OVL 



CPM 



OAV loaded here 



address to load 



18.1.4 List of current LFSs. 

LOCATION FREE ROUTINES 

(AS OF LEVEL 5 - AUGUST, 1974) 

OAV - Verify user number 

OBF - Begin file 

ODF - Drop file 

OFA - Called by DF to release FA files 

ORF - Update RESEXDF and RESEXVF 

OPR - Release PF 
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Figure 18-1. COMPREL (Cont'd) 
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Figure 18-1. COMPREL (Cont'd) 
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RLIM - DEFINE RELOCATION FOR -H- TYPE INSTRUCTIONS. 
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Figure 18-2. COMPRLI 



Also, if -d- field specified, the in field is relocated by LA using the remote table and sub- 
routine REL. 

i.e., CRM m, d 

so, REL will redefine it during execution as 
6 Id m+(LA) which is CRM m+(LA), I 

unless m is a SYSTEXT symbol, then there is no relocation. 

If there is no -d- field specified, then just set -d- field = (LA) and don't list in the 
remote table. 

i. e. , CRM m will be relocated at assembly time as CRM m, (LA) 

and REL will not further relocate this instruction during execution. 
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RLIO - DEFINE RELOCATION FOR -I/O- INSTRUCTIONS. 



RLIO OPC, CODE 

ENTRY *OPC» = INSTRUCTION MNEMONIC. 
•CODE» = OPERATION CODE. 
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Figure 18-2. COMPRLI (Cont'd) 
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Figure 18-2. COMPRLI (Cont'd) 
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as to which MACRO placed the address into the table. Effectively, every instruction 
pointed to by this list will have the m part relocated by (LA). 
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Figure 18-2. COMPRLI (Cont'd) 
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ODF IS A LOCATION FREE ROUTINE TO BE USED FOR 
DROPPING ANY SYSTEM FILE. 

IF FILE IS TYPE 'COMMON*, FILE HILL BE RELEASED FOR USE 
BY OTHER JOBS. ALL OTHER FILES HILL BE REMOVED FROM FNT 
AND THE ASSIGNED EQUIPMENT OR TRACKS HILL BE RELEASED. 



CTEXT COMPMAC - PP SYSTEM MACROS. 

CTEXT COMPREL - LOCAT I ON FREE OVERPLAY MACROS. 

REL$ not defined indicates full relocation 

i. e. SYSTEXT symbols are redefined so user must append ". " , if they are not to 
be relocated, (see address 450) 
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Figure 18-3. ODF _ Example of COMPKEL 
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This allows the 5 word header to start at (LA) 
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IF NO FST AODRESS 
READ FST FNTRV 
READ FNT ENTRY 

CHECK FILE TYPE 
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RTU - RETURN TAPE UNIT. 
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Figure 18-3. ODF - Example of COMPREL (Cont'd) 
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Figure 18-3. ODF - Example of COMPREL (Cont'd) 
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IF NOT SAME TRACK 

SAVE FNT ADDRESS OF FAST ATTACH FILE 



CHECK FOR FAST ATTACH FILE 
IF FAST ATTACH FILE 

IF NOT LAST FILE ON EQUIPMENT 

CHECK FOR INTERCHANGABLE DEVICE 
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RSTR RESTORE INSTRUCTIONS 

All Instructions following RSTR will not be relocated 

END 



Figure 18-3. ODF - Example of COMPREL (Cont'd) 
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OAV IS A LOCATION FREE ROUTINE HHICH VERIFIES THAT 
THE SPECIFIED USER NUMBER IS A VALID ONE. THE VALIDATION 
FILE FOR THE CORRECT FAMILY IS SEARCHED FOR THE GIVEN USER 
NUHBER AND THE VALID USER INDEX IS RETURNED IF FOUND. 
THE ACCOUNT RECORO BLOCK IS ALSO SET UP FOR THE CALLER, S USE. 
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ENTRY CONDITIONS. 
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Figure 18-4. OAV -Example of COMPRLI 
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tTl - TZI = IF THE USER- NAME HAS NOT FOUND. 

tU - TZ) = USER INDEX IF FOUNO. 

«T3> = FHA OF ACCOUNT RECORD BLOCK. 

(Tl») '0 UI DOES NOT EXCEED AUIMX. 

(T«t> » 1 UI EXCEEOS AUIMX. 

<T5> = FAMILY EQUIPMENT. 
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CTEXT COMFMAC - PP SYSTEM MACROS. 

CTEXT COMPRU - RELOCATABLE OVERLAY MACROS. 
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Figure 18-4. OAV _ Example of COMPRLI (Cont'd) 
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DISK POSITIONED. 
(T6) = TRACK. 
(T7» = SECTOR. 
CHANNEL ATTACHFO. 



(A) « IF ERROR. 
CALLS RNS, CRA, CAN, SBL, SRI. 
USES Tl, T3, RI - RI*l. 
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ENTRY/ EXIT 

READ NEXT SECTOR 

READ NEXT SECTOR 
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IF NOT BEFORE FIRST ENTRY IN BLOCK 
IF LEVEL - 
EXIT ERROR FLAGED 
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Figure 18-4. OAV - Example of CO MP R LI with REL$ Defined 
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SUN - SEARCH FOR USER NUMBER. 



ENTRY VALIDATION FILE ATTACHED. 
(UN - UN + 3) = USER NUMBER. 



LOCATE PRIMARY LEVEL BLOCK FOR ACCOUNT NUMBER. 
SYSTEXT defined symbol 
ENTRY/EXIT 

SEARCH INDEX BLOCK (LEVEL 01 
IF 8A0 AODRESS 
POSITION OISK 

SEARCH INDEX BLOCK (LEVEL 1) 
IF BAD INDEX 
POSITION DISK 
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READ NEXT SECTOR 
SET FLAG FOR HIT 
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STO 
SHN 
STO 
LDN 
STO 
LOO 
LPN 
SHN 
LMD 



T2 

-11. 

II 



Ti. 

Tl 

37 

111 

T2 



SET USER INDEX 

CLEAR UI EXCEEO FLAG 
CHECK UI FOR > AUTMX 



OAV 


90 


OAV 


91 


OAV 


92 


OAV 


93 


OAV 


91. 


OAV 


95 


OAV 


96 


OAV 


97 


OAV 


98 


OAV 


99 


OAV 


100 


OAV 


101 


OAV 


102 


OAV 


103 


OAV 


10<t 


OAV 


105 


OAV 


106 


OAV 


107 


OAV 


108 


OAV 


109 


OAV 


110 


OAV 


111 


OAV 


112 


OAV 


113 


OAV 


11<| 


OAV 


115 


t)AV 


116 


OAV 


117 


OAV 


118 


OAV 


119 


OAV 


120 


OAV 


121 


OAV 


122 


OAV 


123 


OAV 


121. 


OAV 


125 


OAV 


126 


OAV 


127 


OAV 


128 


OAV 


129 


OAV 


130 


OAV 


131 


OAV 


132 


OAV 


133 



Figure 18-4. OA.V - Example of COMPHLI with REL$ Not Defined 
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SEARCH INOEX BLOCK. 



CFTOV) = FIRST TRACK. 
OISK POSITIONED. 
IT6) = TRACK. 
(T7> = SECTOR. 
CHANNEL ATTACHED. 



<A> < IF ERROR. 

CAN, SBL, 
- RI»1. 



ENTRY/ EXIT 

REAO NEXT SECTOR 

REAO NEXT SECTOR 

SET LIHIT OF INOEX ENTRIES IN BUFFER 

DECREMENT ENTRY 



IF NOT BEFORE FIRST ENTRY IN BLOCK 
IF LEVEL - 
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Figure 18-4. OAV - Example of COMPRLI with REL$ Not Defined 
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FIRST TRACK OF VALIOATION FILE 
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RETURN 

CHECK ENTRY 
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CHECK LEVEL 
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RETURN 
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Figure 18-4. OAV - Example of COMPRLI with REL$ Not Defined 
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19.0 INTRODUCTION 

By using the COMCMAC common routine, the CPU programmer can display information 

on the K display, and receive keyboard input. The CONSOLE macro generates the necessary 

signal informing DSD that the K display facility is desired. 

19. 1 CONSOLE A COMPASS MACRO 

When the CPU programmer wishes to display on the K display, he uses the CONSOLE A 
COMPASS macro (Figure 19-1). This causes the display of a central memory buffer. 

24 18 18 

A VFD 1. KBUF | RSCR | LSCR| 

KBUF BSSZ 8 KEYBOARD BUFFER 

10 1 1 47 1 

LSCR VFD |0 I S I Fl TH 

LEFT-SCREEN CONTROL WORD 

10 11 47 1 

RSCR VFD |p ! S | F| jl | 

RIGHT-SCREEN CONTROL WORD 

Where : 

S = Character size 

= Small (64 characters /line) lines 12B units apart. (Display is 1000B x 

1000B units) 

1 = Medium (32 characters /line) lines 24B units apart. 

F = Format 

= Program formatted = after the display is selected, data is output until 

a zero in byte (0) of a word is encountered or until 1000B words have 
been output . The data must contain all coordinates 

1 = Coded format ("C" format) - The buffer is assumed to be in "C" format 

(line is terminated when byte (0) contains a zero) and is output until a 
zero is encountered in byte (0) of the first word in a line, or until 1000B 
words have been displayed. 

Figure 19-1. Console A COMPASS Macro Format 



97404700A 10 -! 



I = Display status 

If this is preset to zero (0), it may subsequently be checked for non-zero (which 
indicates data has been displayed at least once). 

Figure 19-1. Console A COMPASS Macro Format (continued) 



NOTE* 
The KRONOS LOADER will only relocate on 30-bit boundaries. 
Therefore, unless the CPU program is in absolute mode (COM- 
PASS pseudo op ABS), the COMPASS assembler will flag A with 
an address error. 

To use this display from a relocatable format, the following is used: 

24 18 18 /Data 

define A ' VFD 10 I I ~"0~1 

then code: SX6 LSCR 

SX1 RSCR 

SX2 KBUF 

LX1 18 

LX2 36 

BX6 X6+X1 

BX6 X6+X2 

SA6 A 



19.2 DISPLAY BUFFER 

The first word of the display buffer is the LSCR or RSCR word. For example: 

10 1 1 47 1 

LSCE VFD 10 I 1 101 I 0l 

12 36 12 
This translates as VFD I 2 | I I For small characters, it should be coded 

12 36 12 
VFD I 2 | | -Q~l 



To further illustrate this format, assume that 

10 1 1 47 1 

LSCR VFD 10 j 1 I I I H 

is given. This then translates as VFD y£ | Q | | | However if small size 
characters are desired, the line should be coded as VFD i Q i q 1 — j— i 



| *This is no longer necessary. This loader problem was fixed at level 2. 

!9_2 97404700C 



The user can test bit later in the program to determine if this buffer was displayed 

19.2.1 Display Grid Coordinates 

The rest of the line is interpreted as coordinates and BCD data, which can appear in any 
order. Note that the central program is responsible for supplying coordinates. The user 
can break the display up into a grid that consists of 51 lines and 64 columns. The spacing 
between columns is 8 coordinate positions and between lines it is 10 coordinate positions. 
The area that the central program can use are those lines below line 4 and above line 48 . 

Think of the display grid in terms of an X and Y axis, where £6000, 7000) is the lower 
left point of reference and the corners are as shown in Figure 19-2. 



(6000B.777Y.ts) 



(6000B, 7000B) 



(6777B, 7777B) 



'(6777B.7000B) 



Figure 19-2. Display Grid Corner Reference Points. 

However, it is tedious to map characters onto this grid. To simplify this process, the 
following macro can be used. 



** 



DSL - DEFINE DISPLAY 

WHERE X=X COORDINATE 
Y=Y COORDINATE 
A=CONSTANT TO BE DISPLAYED 



DSL MACRO 
B MICRO 

C MICRO 

VFD 

DATA 
ENDM 



X, Y, A 

i, 6, $A$ 

7,,$A$ 

12/6000B+X*08, 12/7756B-Y* 10,36/6H"B" 

H$"C"$ 



According to this macro, the user may invision the grid as shown in Figure 19-3. 
(0,4) — ,(64,4) 



(o,m 



— 1(64,48) 



Figure 19-3. Display Grid Displayed 
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In actuality, the user can use these lines above line 4 and below 48; however, he will over- 
lay the standard K display DSD information which should be avoided. 

19.2.2 Display Modifications 

If the user wishes to change selected pieces of the display, it is recommended that cells 
be defined into which BCD information can be stored. Since DSD interprets a zero in 
byte (0) of any word as an end-of -buffer, these locations must have 5555B in byte (0) in 
order to display the rest of the buffer. 

In order to have some parts of the display at a higher intensity, the user merely repaints 
selected parts of the display. For example, the user can increase the intensity of line 
43 by using the DSL macro as shown below: 

DSL 0, 43, data 

DSL 0, 43, data 

Flashing of selected parts of the display can be easily coded since any word of zero will 
act as an end- of -buffer. By placing selected coordinates after a nominal end-of-buffer (word 
of zeros), the user can set this word to zero, then non-zero according to some counter 
(see example for a sample of this code). 

■When receiving information from the keyboard, the buffer (KBUF in this case) is filled 
with characters when the CR key is pressed. Characters are transmitted to KBUF from 
the keyboard left justified, 10 per word until exhausted The last word is not filled 
beyond the final keyboard entry. If one zeroes KBUF prior to receiving entries, the first 
six bits of zero will signal end-of-information. 

A CPU program which communicates with DSD via the keyboard should have a main loop. 
This could be flow charted as shown in Figure 19-4. 



19-4 97404700A 




No 



Save 

Keyboard 

Buffer 



T 



Zero 
Keyboard 

Buffer 



T 



rocess 



and Acknow- 
ledge Request 



Note that one must go into periodic recall since, 
there is no practical way to insure that a 
completion bit will be set with no PP activity 
and the CP may hang. 



Figure 19-4. Sample Main Loop 



19.3 



DISPLAY PROGRAMMING 



Figures 19-5 and 19-6 illustrate an example of a program using the K display. More 
examples can be found in the routines STAGE, PFS, and MODVAL. Note that these three 
routines are in (ABS) absolute mode, but the example is in relocatable mode. 
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DSL 




DSL 




DSL 




DSL 


INV 


DATA 


INV1 


DATA 


INV1A 


DATA 


FLASH 1 


DATA 




DSL 


INVB 


DATA 


INV IB 


DATA 


INV1AB 


DATA 




DSL 


INVC 


DATA 


INV1C 


DATA 


INV1AC 


DATA 




BSSZ 



12/2,36/0, 12/2 

16, 5, (TELEX LINE TABLE) 

2.8, < CREATED) 

2L 

2, 11, ( LAST MOD) 

2L 

8. 14, (OPTIONS AVAILABLE ARE) 

14,17.(1 = INQUIRE) 

14, 19, (C = CREATE) 

14.21, (D = DELETE) 

14,23. (M = MODIFY) 

14, 25, (S = SHOW) 

10. 30, (FORMAT IS X, Y) 

4, 33, (WHERE X = OPTION) 

16,36, (Y = LINE NUMBER - MAX 99) 

22, 38. ((EXPANDABLE TO 64000)) 

10, 41, (TO STOP RUN TYPE END) 



FILL IN DATE 



FILL IN DATE 



0,43,( ) 
2L 

2L 
2L 
2L 




INVALID MESSAGE WILL BE 

OVER LAYED HERE 

TYPE IN FIELD DISPLAY 

THIS CELL ALTERNATES BETWEEN & 5555B IN 

UPPER BYTE IN ORDER TO FLASH INV, INV1 

and INV1A 



DOUBLE INTENSITY 



TRIPLE INTENSITY 
END OF BUFFER 



Figure 19-5. Left Screen Display Buffer 
If small letters are desired, word DISP1 should be written as: 
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DISP1A 



VFD 


12/0,36/0, 12/2 


buffer 




VFD 


12/2,36/0, 12/2 


DSL 


20.8, (SST 07) 


DSL 


11, 16, (TELEX LINE) 


DSL 


20, 21, (SWITCHING) 


DSL 


14,28. (MASTER CONTROL) 


DSL 


19, 36, (ROUTINE) 


BSSZ 


1 END OF BUFFER 



Figure 19-6. Right Screen Display Buffer 
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The following routine generates the VFD CMA, CMI, and CMS. It also places the date 

int'O the diSDlav- Hisnla-u-a the HnffoT" ai-irl iraitq f^->v Vmrkn^v./) 



Xll^Lil. . 



J.111S i yuuuc is (jiixy 



used initially. Thereafter, the next routine, MAJOR, is used. 



COMPASS - VER 2. 73/04/25. 12 53.00. 



BDIS 

BLANK 

FL4 

FLASHC 

INVALID 

SPACE 

INBUF 

DATA 

CMA 

CMI 

CMS 

SETK 



OK 



DIS_ 

jjA t A 

DATA 

DATA 

DATA 

DATA 

BSSZ 

DATA 

VFD 

VFD 

VFD 

BSSZ 

SX6 

SX1 

LX1 

SX2 

LX2 

BX6 

BX6 

SA6 

SX6 

SX1 

LX1 

BX6 

BX6 

SA6 

SX6 

BX6 

SA6 

DATE 

SA1 

BX6 

SA6 

SA6 

SA6 

SA6 

MESSAGE 

CONSOLE 

O A 1 

OjTI J. 

NZ 

RECALL 

EQ 

BXS 

SA6 

EQ 



, * REQUEST 

2L 

200B 

1 

10 BIN VALID 

1H 

8 



24/0, 18/0, 18 

24/0, 18/0, 18 

24/0, 18/0, 18 

1 

DISP1 

DISP1A 

18 

INBUF 

36 

X6+X1 

X6+X2 

CMA 

DISP2 

DISP3 

18 

X6+X1 

X6+X2 

CMI 

DISPS 

X6+X2 

CMS 

DATE 

DATE 

XI 

DATE1 

DATE2 

DATES 

DATE4 

BDIS, 1, R 

CMA 

INBUF 

XI, OK 

BEGIN 

XI 
IN 
SETK 



K DISPLAY* 
FLASHING SPEED BIGGER NO = SLOWER FLASHING 



/0 24/INBUF, 18/DISPLA, 18/DIPS1 
/0 24/INBUF, 18/DIPS3, 18/DISP2 
/0 24/INBUF, 18/0, 18/DISPS 

ADDRESS 
ADDRESS 



24/INBUF, 18/DISPLA, 18/DISP1 



24/INBUF, 18/DISP3, 18/DISP2 

These buffers are not shown in this example 

24/INBUF/ 18/0, 18/DISPS 
This buffer is not shown in this 
example get date from system 



These cells are part of another buffer 

not shown in this example 
WAIT FOR MESSAGE TO BE DISPLAYED 

Ck for input 



LOOP TILL WE GET KEYBOARD ENTRY 
argument from calling routine 
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The following routine is called for all subsequent displays of this buffer 



MAJOR 



MAI 



BLINK 1 
OKU 



BSSZ 

SA1 

BX6 

SA6 

SA6 

SA6 

CLEAR 

MX6 

SA1 

SA2 

SA6 

SA6 

SA6 

SA6 

SA6 

SA6 

SA6 

BX6 

BX7 

SA6 

SA6 

SA6 

SA7 

SA7 

SA7 



INBUF 
XI 

INV1A 
INV1AB 
IN VIA C 
KEYBOARD 


CINV 
CINV1 
INBUF 
A 6+1 
A6+1 
A 6+1 
A 6+1 
A 6+1 
A 6+1 
XI 
X2 
INV 
INVB 
INVC 
INV1 
INV1B 
INV1C 



CONSOLE 

BSS 

SA1 

SA2 

NZ 

RECALL 

SA1 

SA2 

SA3 

SA4 

SX6 

SA6 

NZ 

SX7 

SA7 

ZR 

MX6 

SA6 

EQ 

BX6 

SA6 

EQ 

BSS 

BX6 

BX7 

SA6 

SA7 

EQ 



CMA 


INBUF 
A 1+1 
Xl.OKll 



Last keyboard entry 



For Flashing 



argument from calling routine 



For flashing 



For flashing 



*\ 



FLASHC 

BLANK 

FLASH1 

FL4 

Xl-1 

FLASHC 

X6.MA1 

X4 

FLASHC 

X3, BLINK 1 



FLA SHI 

MAI 

X2 

FLASH1 

MAI 



XI 

X2 

IN 

IN+1 



1 



— Flashing Code 



ZERO OUT AND INDICATE EOB 



NON ZERO AND INDICATE NOT EOB 
LOOP TILL KEYBOARD RESPONSE 



ARGUMENTS RETURNED TO CALLING ROUTINE. 



MAJOR' 
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DSD will refresh the last display automatically until a new display is requested The user 

can modify the display buffer while it is being displayed. This dynamic facility allows the 
use of flashing code . 

The preceding example produces the following left (Figure 19-7) and right (Figure 19-8) 
screen displays. 



TELEX LINE TABLE 
CREATED XX /XX/XX 



OPTIONS AVAILABLE ARE 




I 

C 

D 

M 

S 



= INQUIRE 

= CREATE 

= DELETE 

= MODIFY 

= SHOW 
FORMAT IS X Y 
WHERE X = OPTION 

Y = LINE NUMBER - MAX 99 

(EXPANDABLE TO 64000) 
TO STOP RUN TYPE END 
(INVALID TYPEIN) 




This will flash at 
triple intensity 



Figure 19-7. Left Screen Display 
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SST 



TELEX LINE 
SWITCHING 



MASTER CONTROL 
ROUTINE 



Figure 19-8. Right Screen Display 
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The following display on Figure 19-9 is produced by the following program in Figure 19-10. 
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o 



o 
O 





Figure 19-9. Left and Right Screen Display 



CM FUNCTION CONSOLE«005>. 



COMPASS J.7<.25'j. 



7t/12/ll. l<i. Oil. m. 



O 







ost 


MACRO 


X.Y.A 






a 


MICRO 


1,6, SAt 






c 


MICRO 
VFO 
OAT» 
ENOH 


T,,tA« 

12/6900 
H»-C-$ 







CONSOL 


ass 




o 


711001)0036 » 




CCNSOL 


F OISP 


2 




CPM1 


BSS 




2 


511000001.7 ♦ 




SA1 


LS 




30173 




LX1 


59-0 


1 


0331000005 * 

01CJOOOOOO X 




NG 
RECALL 


X1.CPM2 


k 


01.0000008? » 




EO 


CPM1 


5 




CPM2 


xss 




5 


SU0000101 « 




SAl 


IS 




20173 




LX1 


59-0 


6 


013100001! < 




NG 


XI.CPM3 




5110000031. ♦ 




SAl 


BLANKS 


7 


10611 




BX6 


«1 




6160000057 » 




SA6 


LSI 


10 


0100080600 X 




RFCALL 




11 


oitoosaooos » 




EO 


ri>M2 



IDEM CONSOL 
ENTRY CONSOL 

XTFXT COMCMAC 

OSL - DEFINE -DISPLAY LINE 

HHERF X - X-COOROINATE 
Y * Y-COOROIKATE 
» = DATA TO BE DISPLAYED 



I2/600OBK«»,ie/7756B-»»U.T./6H"B- 



SYSTEH MILL REQUFST «K» DISPLAY 



IF LEFT SCREEN OISFLAYEO 

LOOP UNTIt LE C T SCEEN IS 01SPLAYEO 



IF RIGHT SCREEN 1ISPLAYEO 

1ISPLAY ^FSSAGf TO OPF D »TOR 
LCOP UNTIL ^IGHT SCR^FN ALSO I< 



12 






12 


1.3609 

5160000057 » 

66700 




13 


6150000012 




11. 






11. 


5117100067 1 

10611 




15 


5167000060 • 






5167000111. 


f 


16 


6177000001 






0557000011. 


+ 



THE FOLLOWING CODE "UTS OUT A FI.SSHING NFSTSCF S^'IKG FCR 
AN CPf^ATOR IYT-IN. Ilf M«S';AGE f. ALU ><NATING ?£THEEH 
THE LFFT AN3 RISHT SCREENS. 



BSS 




MX6 





SA6 


LSI 


SB7 


10 


S65 


LTYPE 


nss 




SAl 


IYPF,97 


BX6 


XI 


SAG 


LS1»1»B7 


SA6 


PS1»1>97 


SB7 


B7»l 


NE 


15.B7.CPMl. 



MCVE OPE'AIOR MrSSAGE TO OISPLAY AREA 



IF NOT FINISHED 



figure 19-10. Program Display of Figure 19-9. (Sheet 1 of 2) 



CPU FUNCTION CONSOLE(0051. 



COMPASS 3.71.259. 



7I./12/11. l<t. 0l>. Ct . 



17 
17 

30 
21 

22 

23 

2". 

25 

26 

27 



JO 

30 



32 
32 



5110000037 « 

0311000032 » 
O1O000000O X 
511000003). » 

512000003; • 
5130000057 » 

7262777776 
516D000035 ♦ 

0316000017 * 
7170000310 

5170000035 » 
0303000030 • 

•(3500 
5160000057 » 

10*11 
5160000113 • 

OI.C0000017 » 



1.3600 

5160000113 » 

10611 
5160000057 » 

01)00000017 » 



716021(7021 



BSS 




SA1 


KBUF 


IT 


X1.CPM7 


RECALL 




SA1 


BLANKS 


SA2 


FLASHC 


SA1 


LSI 


SK6 


X2-1 


SA6 


FLASHC 


HZ 


X6.CPH5 


SX7 


200 


SA7 


FLASHC 


ZR 


X1.CPH6 


MX6 





SA6 


LSI 


9X6 


xl 


S»6 


RSI 


EO 


CPUS 


BSS 




HX6 





SA6 


RSI 


8X6 


XI 


SA6 


LSI 


EQ 


CPM5 


BSS 




ENORUN 





IE SOME KEYBOARD If.PUT 



DECREMENT FLASH COUNTER 

IF NOT TIME TC CHANCE STATUS 
RESET FLASM COUNTER 

IF LEFT 1ISPLAY OFF 
LEFT DISPLAY CN.... 
SO TURN IT OFF 

TURN ON RIGHT SCREEN 



TURN OFF RIGHT OISPLAY 



TURN ON LEFT DISPLAY 

LOOP WAITING FOR KEYBOARO INPUT 



o 
Ji. 
^] 
o 
o 
O 



3d 
35 
36 



37 
<|7 
50 
52 
5I> 
57 
60 
53 
66 
67 
72 
75 
100 

101 
102 
105 
110 
113 

126 



555555555555555555 55 
00000000000000000001 
00000037 V 

000101 ♦ 

00001.7 

10 
00020000000000000000 
5000 761255555S551I.05 
6000761255555555 11.05 
6000 756621.052 J2I.5517 
000000000000000000 00 
600075162011.05012305 
600 071.72221 10 71021.55 
00000000000000000000 
60007516201*05012305 
600075162011.05012305 
600075162011.05012305 
00 000000 000000000000 

12 
00020000000000000000 
60007612555555552211 
60007612555555552211 
600075662*05232<>S$17 
00 0000 000 00 0000000 

12 



BLANKS OATA 10H 

FLASHC DATA 1 

OISP VFD ?*/KBUF,18/RS,15/LS 



KBUF 
LS 



LSI 



TYPE 



LTYPF 

RS 



RSI 



BSSZ 

VFD 

DSL 

OSL 

DSL 

DATA 

OSL 

DSL 

DATA 

DSL 

DSL 

DSL 

OATA 

EOU 

VFD 

OSL 

OSL 

OSL 

DATA 

BSS? 

END 



510000 CM STORAGE USED 



10/0,1/1, 

0,10, ( 

0,10,1 

0,12, tTES 



0.16. (PLE 

O.K. (RIG 



0.16, (PLE 

0,16, (PLE 

0.16, (PLF 



•-TYPE 

10/0,1/1, 

0,10,1 

0,10, ( 

0,1?, (YES 



LTYPE 

CONSOL 



1/0, ".7/0, 1/0 

LEFT SCREEN. I 

LEFT SCREEN,! 
T OF 'CONSOLE* MACRO. » 

ASE BRING K-DISPLJY TOI 
HT SCREEN ALSO.) 

ASE TYPE SOMETHING IN.t 
ASE TYPE SOMETHING IN. I 
ASE TYPE S01FTHING IN.) 



1/0,1.7/0,1/0 

RIGHT SCREEN. ) 

RIGHT SCREEN.) 
T OF 'CONSOLE' MACRO. 



151 STATEMENTS 



21 SYM10LS 



Figure 19-10. Program Display of Figure 19-9. (Sheet 2 of 2) 
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20 . INTRODUCTION 

KRONREF and Common Decks are both pertinent to the system library (OPL). KRONREF 
is used to locate particular usage of items such as symbol, type, common deck, etc. 
Common decks are all on the OPL, thus the majority of jobs can be accomplished without 
special macro definitions. 

20 . 1 KRONREF 

KRONREF is useful to the programmer who wishes to locate a particular use of a symbol, 
type, error flag, common deck, or PP package. 

KRONREF generates a cross-reference listing of system symbols used by decks on a 
MODIFY OPL. A sample of the KRONREF cross-reference listing is given subsequently. 
The names of programs on the OPL are listed for those decks that reference the following: 

PP direct cell locations defined in lfn„ or lfn, 

PP resident entry points defined in lfn„ 

Monitor functions 

Central memory pointers (in low core) defined in lfn, or lfn 

6 4 

Central memory locations (in low core) defined in lfn or lfn. 

Control point area words defined in lfn„ or lfn. 

Dayfile message options 

File types and mass storage constants 

Job origin types, queue types, and priorities 

Error flags referenced 

Common deck calls 

PP packages called *1 

The KRONREF control card format is: 

KRONREF(P=lfn 1 . L=lfn 2 . S=lfn 3> G=lfn 4 > 

P=lfn. OPL input from file lfn,. If the P option is omitted or P alone is 

specified, file OPL is assumed 

L=lfn„ List output on file lfn2. If the L option is omitted or L alone is 

specified, file OUTPUT is assumed. 

S=lfn, System text from overlay lfrt3 . If the S option is omitted or S 

alone is specified, file SYSTEXT is assumed. 

*1 Macro EXECUTE nme, = does not generate code to RJM to EXR, but is used exclusively 
to make a reference for KRONREF to use. 
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Grlfn 4 System text from local file lfoj . If G is omitted, system text is acquired 
as specified or defaulted by the S option. If G alone is specified, local file 
TEXT is used. Use of the G option overrides any S specification. 

As an example, Figure 20-1 gives the references to monitor functions and central 

memory pointer words. 

20.2 COMMON DECKS 

The KRONOS common decks are organized in the following classes. 

CP common decks 
PP common decks 
Equivalences 
Table management 
Display routines 
TRANEX common decks 

All common decks are on the system library (OPL). Each common deck is identified by 
the name COMxnnn on the OPL . 

where: 

x = the letter signifying the type of common deck: , 

where: 

C = CP common deck 

P = PP common deck 

S = Equivalence type 

T = Table management type 

D = Display type 

B = TRANEX type 

nnn = a three-letter designator usually equal to the entry point used in the common 
deck. 

For example, COMCARG is a CP common deck with a subroutine entry point of ARG. This 
is the argument processing subroutine. 

20.2.1 COMCMAC/COMPMAC 

Common decks of particular interest are COMCMAC and COMPMAC. These two common decks 
contain generally used by system-origin jobs . The most frequently used macros are defined 
in SYSTEXT as CPCOM and PPCOM. Thus, non system-origin jobs (the majority of jobs) 
can be written without the need for calling a special common deck of macro definitions. 
The COMPASS pseudo-op SST causes the assembly of either the CPCOM or PPCOM 
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CROSS REFERENCE OF OPL 
MONITOR FUNCTIONS 



OPL FILE -OPL, SYS. TEXT = SYSTEXT (KRONOS 2. t-Ol/AA) 73/08/29. 11.41.29 PAGE 6 



o 

-4 


SYMBOL 

AEQM 


VALU1 
1 


3 DECK UKFJi 
COMDTFN 


MTR 


a. 


1DS 


















o 
o 


AMSM 


2 


COMDTFN 


CIO 




LFM 


MTR 


PFM 


PPR 


XSP 


1CJ 


IDS 


1RO 


ITA 


O 


CCHM 


3 


COMDDSP 


COMDTFN 


DSD 


MTR 


1TO 
















DCHM 


4 


COMDTFN 


DSD 




MTR 


PPR 


















DEQM 


5 


COMDDSP 


COMDTFN 


BAT 


DIS 


LFM 


MTR 


REC 


0DF 


1AJ 


1CD 


1CJ 








1ED 


no 




1TD 




















DFMM 


6 


COMDTFN 


MTR 




PPR 




















OFEM 


7 


COMDTFN 


DSD 




MTR 


HO 


IMT 
















ONEM 


10 


COMDTFN 


USD 




MTR 


RMS 


IDS 
















PRLM 


11 


COMDTFN 


MTR 




PPR 


REC 


1SD 


CPUMTR 












RCHM 


12 


COMDTFN 


DSD 




MTR 


PPR 


1ED 
















REMM 


13 


COMDTFN 


CPM 




DIS 


MTR 


















REQM 


14 


COMDDSP 


COMDTFN 


DSD 


LFM 


MTR 


1ED 


no 


1TD 










ROCM 


15 


COMDTFN 
IMA 


CIO 
1SJ 




CPM 
ISP 


DIS 
ITA 


LFM 


MTR 


PFM 


SFP 


1AJ 


1CK 


IDS 




RPRM 


16 


COMDTFN 
1RI 


CHD 
ISP 




CPM 
ITA 


DIS 
1TD 


MTR 


026 


SLL 


SMP 


1AJ 


IDS 


IMT 




RJSM 


17 


COMDTFN 


MTR 




SFM 


1AJ 


IDS 


ISP 


ITA 


2TJ 










SCHM 


20 


COMDTFN 


MTR 




6DD 


6DII 


6DI 


6DP 


6MD 












RSTM 


21 


COMPRSI 


COMDTFN 


ADC 


DAT 


CMS 


DOG 


DS1 


MTR 


REC 


SLL " 


STL 








WRM 


1AJ 




1CJ 


HO 


as 


IRI 


mo 


1SJ 










RSYM 


22 


COMDTFN 


CIO 




CLL 


EXU 


MTR 


PPR 


SFP 


1AJ 


1DL 








SMSM 


23 


COMDTFN 


DSD 




MTR 




















STPM 


24 


COMDTFN 


DSD 




MTR 




















TGPM 


25 


COMDTFN 


MTR 




IDS 


1TO 


















TSEM 


26 


COMDTFN 


CPM 




MTR 


TLX 


1AJ 


IDS 


IRI 


ITA 


1TD 


1TO 






DEPM 


27 


COMDTFN 


MTR 
























DRCM 


30 


COMDTFN 


CIO 




MTR 


STL 


IMT 
















SCPM 


31 


COMDTFN 


CPM 




MTR 




















EATM 


32 


COMDTFN 


CPM 




MTR 


DFA 


ORP 


IMT 


ISP 












CPUM 


36 


COMPMRQ 


MTR 




PPR 


CPUMTR 
















ABTM 


36 


COMDTFN 


ADC 




BAT 


CHD 


CLL 


CMS 


CPM 


DIS 


DOG 


DSl 


EXU 








LFM 


026 




PFM 


PFU 


SFM 


SFP 


SLL 


SMP 


TLX 


WPM 


XSP 








1AJ 


1LS 




IMA 


1MT 


CPUMTR 














CCAM 


37 


COMDTFN 


REC 


- 


RMS 


SLL 


STL 


XSP 


1CK 


IDS 


IMT 


1RO 


1SJ 








ISP 


ITA 




CPUMTR 


















CEFM 


40 


COMDDSP 


COMDTFN 


CIO 


DIS 


DSD 


MTR 


026 


SFP 


XSP 


1AJ 


IDS 








1ED 


1MT 




IRI 


1TD 


CPUMTR 














OCPM 


41 


COMDTFN 


CHD 




DIS 


EXU 


MTR 


026 


SMP 


1AJ 


1LS 


CPUMTR 




DJSM 


42 


COMDTFN 
CPUMTR 


CPM 




DIS 


DSD 


026 


SFM 


SLL 


XSP 


1CK 


IDS 


ITA 




DTKM 


43 


COMDTFN 


CIO 




IMS 


LFM 


PFM 


PFU 


PPR 


REC 


RMS 


SFM 


SFP 


to 






SLL 


ISP 




0DF 


0RP 


1CD 


1CJ 


1CK 


IDS 


IRI 


1RO 


ITA 


o 

LO 






1TO 


CPUMTR 






























Figure 20- 


1. Cross Reference of OPL. 











to 

o 



CROSS REFERENCE OF OPL. OPL FILE OPL SYS. TEXT=SYSTEXT (KRONOS2. l-01/AA)73/08/29 1 1. 41 . 29 PAGE 7 

MONITOR FUNCTIONS 

SYMBOL VALUE DECK REFERENCES" 



*>. 


DPPM 


44 


COMDTFN 


ADC 


BAT CUD • 


CHK 


CIO 


CLL 


CMS 


CPM 


DIS 


DOG 








DS1 


EXU 


IMS LFM 


MTR 


OUT 


026 


PFM 


PFU 


PPR 


REC 








SFM 


SFP 


SLL SMP 


STL 


TLX 


WRM 


XSF 


OBF 


1AJ 


1BA 








1CD 


1CK 


1DL IDS 


1ED 


no 


1LS 


IMA 


1MT 


1RO 


1SJ 








1TA 


1TD 


1TO CPUMTR 
















ECSM 


45 


COMDTFN 


6DE 


CPUMTR 


















RCLM 


46 


COMDTFN 


CHD 


DIS DSD 


MTR 


1TD 


CPUMTR 










RCPM 


47 


COMDTFN 


CHD 


DIS - EXU 


SMP 


STL 


1AJ 


1RI 


1RO 


CPUMTR 




RDCM 


50 


COMDTFN 
CPU MTU 


CPM 


REC SFM 


1AJ 


1BA 


1LS 


1MT 


1RO 


1TA 


1TD 




REWM 


51 


COMDTFN 


CPUMTR 




















RJAM- 


52 


COMDTFN 


1CJ 


CPUMTR 


















RPPM 


53 


COMDTFN 

1SJ 


IDS 
1TD 


DOG DSD 
CPUMTR 


MTR 


026 


SMP 


STL 


1CD 


1LS 


1MT 




RSJM 


54 


COMPRSI 


COMDTFN 


CPM DIS 


DSD 


MTR 


026 


SFM 


SLL 


XSP 


1AJ 








1CD 


1CK 


IDS 1LS 


1RI 


1RO 


IS J 


ISP 


1TA 


CPUMTR 




RTCM 


55 


COMDTFN 


CIO 


IMS MTR 


PFM 


PFU 


PPR 


REC 


RMS 


SLL 


XSP 








OBF 


1BA 


1CJ 1CK 


1RO 


1TO 


CPUMTR 










SFBM 


56 


COMPFAT 


COMPSDI 


COMPSFB 


CIO 


CMS 


IMS 


PFM 


PFU 


0FA 


ORF 












COMDTFN 




















ORP 


1LS 


1TA CPUMTR 
















STBM 


57 


COMPCTI 


COMPSII 


COMDTFN 


PFM 


PFU 


RMS 


ORP 


CPUMTR 














IMS 


















UADM 


60 


COMDTFN 


CIO 


CPUMTR 


















WEHM 


61 


COMDTFN 


CPUMTR 




















JACII 


62 


COMDTFN 


MTR 


REC 1AJ 


1CJ 


1RI 


1RO 


1SJ 


CPUMTR 






DLKM 


63 


COMDTFN 


PFM 


CPUMTR 


















TDAM 


64 


COMDTFN 


CIO 


ORF IDS 


1MT 


CPUMTR 












TIOM 


65 


COMDTFN 


1MT 


CPUMTR 


















RTLM 


66 


COMDTFN 


CPM 


DIS 1AJ 


IDS 


1RI 


CPUMTR 










LCEM 


67 


COMDTFN 


1AJ 


CPUMTR 


















CSTM 


70 


COMDTFN 


ODF 


CPUMTR 


















CKSM 


71 


COMDTFN 


SFP 


1AJ CPUMTR 
















MSFM 


76 


COMDTFN 


DIS 


0SO MTR 


ODF 


1MT 


1TA 


CPUMTR 








RPLP 


1 


DIS 


DSD 


PPR REC 


SLL 


STL 


1AJ 


1CK 










PLDP 


2 


DIS 


MTR 


PPR REC 


SLL 


1AJ 


1DL 












PPCP 


2 


COMPMRQ 


DIS 


DSD MTR 


PPR 


SET 


STL 


1TD 


CPUMTR 


























DSDI 






DFPP 


3 


DIS 


DSD 


MTR PPR 


REC 


SET 


SFM 


1CJ 


1CK 


1RI 


1RO 


CO 






CPUMTR 




















o 


JBCP 


4 


COMPRJC 


DSD 


PFM SET 


ISP 


CPUMTR 










*> 
<J 

to 
o 
ta 


FNTP 


4 


COMPFAT 


COMPSAF 


CIO DIS 


D^D 


LFM 


OUT 


026 


PFM 


REC 


SET 



Figure 20-1. Cross Reference of OPL. (continued) 
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Figure 20-1, Cross Reference of OPL. (continued) 



definitions in a routine. In either case, ■whether the macros used are defined in a common 
deck or SYSTEXT, the program must also call the appropriate common deck which contains 
the code to perform the operation requested by the macro. For instance, if the MOVE macro 
is being used, the program must also call the COMCMVE common deck. This call is 
generally done by a * CALL card within the program. However, many of the common 
decks of general (frequent) application are available in relocatable form on the user library 
SYSLIB. In this case, the call is via an external entry point. For instance, RJ =XCIO= . 
A list of these relocatable routines is available in Part I Section 3 of the Installation Handbook. 

In general, the subroutines available in the common decks have been checked out and 
optimized and their use is recommended. The S-type common decks contain symbol 
definitions used in the various subsystems. The display subroutines, D-type, are used by 
DSD, DIS, and other routines which drive the display console. TRANEX common decks 
are available on the TRANEX program library file, KTSPL. 

Individual copies of the common decks can be assembled with the job. 

Example: 

JOBCARD 

ACCOUNT (name, pw) 

ATTACH (OPL) Program Library file 

MODIFY (0, CL r Z)/*EDIT, CALLxxx 

6/7/8/9 
where, 

xxx = CPU - CP common decks 

= PPU - PP common decks 

= SYS - Equivalence type 

= DIS - Display type 

= TAB - Table type 

20.2.2 CP Common Deck 

The following CP common decks are available on the system OPL. 



COMCMAC - CPU System Macro Definitions 

COMCARG - Process Arguments 

COMCARM - Multiple Word Argument Processor 

COMCCDD - Constnat to Decimal Display Code Conversion (Up to 10 digits) 

COMCCFD - Constant to F10 . 3 Conversion 

COMCCIO - I/O Function Processor 

COMCCOD - Constant to Octal Display Code Conversion (Up to 10 digits) 

COMCCPM - Control Point Manager 

COMCCPR - Central Processor Abort Recovery Processor (Similar to REPRIEVE 

in SCOPE 3.4) 

COMCDXB - Display Code to Binary Conversion 
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COMCEDT 
COMCFCE 

PrvHJPT TPTKIT 

\^ W1V1V- XJJL - 1YX 

COMCMTM 

COMCMTP 

COMCMVE 

COMCOVL 

COMCPFM 

COMCPOP 

COMCRDC 

CO?vlCRDK 

COMCRDO 

COMCRDS 

COMCRDW 

COMCRTN 

COMCSFM 

COMCSFN 

COMCSRT 

COMCSSN 

COMCSST 

COMCSTF 

COMCSYS 

COMCUPC 

COMCUSB 

COMCWOD 

COMCWTC 

COMCWTH 

COMCWTO 

COMCWTS 

COMCWTW 



Edit Date or Time from Packed Format 

Format Catalog Entry for Output 

Local File Manager Processor 

Managed Table Macros 

Managed Table Processors 

Move Block of Data 

Load Overlay Processor 

Permanent File Processor 

Pick Out Parameter 

Read Coded Line, -C- Format 



-1/ Ut J~l.i.l3. I. 



Read One Word 

Read Coded Line to String Buffer 

Read Words to Working Buffer 

Read Terminal Network Descriptions 

System File Manager Processor 

Space Fill Name 

Set Record Type 

Skip Sequence Number 

Shell Sort Table 

Set Terminal Output File 

Process System Requests 

unpack ^uiiuui cttiu 

Unpack Data Block to String Buffer 
Convert Word to Octal Display Code 
Write Coded Line, -C- Format 
Write Coded Line, -H- Format 
Write One Word 

Write Coded Line from String Buffer 
Write Words from Working Buffer 



20.2.3 PERIPHERAL PROCESSOR COMMON DECKS 



COMPMAC 

COMPCHI 

COMPCDI 

COMPCIB 

COMPCLD 

COMPCLX 

COMPCOB 

COMPCKP 

COMPCRA 

COMPCRS 

COMPCTI 

COMPCUA 

COMPC2D 

COMPDTS 

COMPFAT 

COMPGnj 

COMPGTN 
COMPIRA 
COMPMRQ 
COMPMSD 



PP System Macros 

Redefine I/O Instructions 

Clear Permanent File Device Interlock 

Check Input Buffer 

Search Central Library Directory 

Clear Exchange Package 

Check Output Buffer 

Set Checkpoint Bit In EST Entry 

Convert Random Address to Track and Sector 

Check Recall Status 

Clear Track Interlock 

Check User Access 

Convert 2 Octal Digits to Display Code 

Determine Track Interlock Status 

Search for Fast Attach File 

^gnArafp T'^3 N2&9 

Generate Terminal Number 

Initialize Random Access Processors 

Monitor Request 

Mass Storage Processor for 853/854/821/841/814 
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COMPRCB 

COMPRCS 

COMPRJC 

COMPRNS 

COMPRSI 

COMPRSS 

COMPSAF 

COMPSCA 

COMPSDI 

COMPSDN 

COMPSEI 

COMPSFB 

COMPSPA 

COMPSNT 

COMPSRA 

COMPSTA 

COMPSTI 

COMPUPP 

COMPtJPS 

COMPVFN 

COMPWBB 

COMPWCB 

COMPWSS 

COMP3XD 

COMPREL 

COMPRLI 

COMPCHL 



Read Coded Buffer 

Read Control Statement 

Read Job Control Word 

Read Next Sector 

Request Storage Increase 

Read System Sector 

Search for Assigned File 

Set Catalog Address 

Set Permanent File Device Interlock 

Search for Device Number 

Search for End of Information 

Set File Busy 

Set Pot Address 

Set Next Track 

Set Random Address 

Set Terminal Table Address 

Set Track Interlock 

Update Pot Pointer 

Unpack Statement 

Verify File Name 

Write Binary Buffer 

Write Coded Buffer 

Write System Sector 

3000 Equipment Driver Subroutines 

Location Free Overlay Macros 

Relocatable Overlay Macros 

Redefine I/O Instructions 



20.2.4 DISPLAY COMMON DECKS 



COMDDIS 
COMDDSP 
COMDSYS 
COMDTFN 



Display Subroutines 

Display Program Routines 

Display System Status and Associated Routines 

Table of Monitor Functions for Display 



20.2.5 SYSTEM COMMON DECKS 



COMSACC 

COMSBIO 

COMSCIO 

COMSDSL 

COMSEXP 

COMSIOT 

COMSIRO 

COMSLDR 

COMSMSP 

COMSMTR 

COMSMTX 

COMSNET 



Account File Equivalences 

Batchio Equivalences 

CIO/Driver Equivalences 

Deadstart Load Parameters 

EI200 Tables and Constants 

Job Output Equivalences 

Job Rollout Equivalences 

CPU Program Loading Equivalences 

Mass Storage Processing Equivalences 

MTR/CPUMTR Equivalences 

Magnetic Tape Executive Equivalences 

Terminal Network Equivalences 
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COMSPFM - Permanent File Equivalences 

COMSPFS - Permanent File Supervisor Equivalences 

COMSPFU - Permanent File Utilities Equivalences 

COMSPRO - Profilo Record Equivalences 

COMSREM - TELEX System Parameters 

COMSkSX - Resource Executive Equivalences 

COMSSFS - Special System File Macros and Equivalence; 

COMSSSJ - Special System Job Parameters 

COMSTDR - Terminal Driver Equivalences 



20.2.6 TABLE COMMON DECKS 

COMTBCD - Display Code to BCD Table 

COMTC29 - COBOL 029 BCD to Display Code Table 

COMTDPC - BCD to Display Code Table 

COMTF29 - FORTRAN 029 BCD to Display Code Table 

COMTS29 - SNOBOL 029 BCD to Display Code Table 



20.2.7 SPECLAL PURPOSE COMMON DECKS 

COMLRUN - Run Library Communication Definitions 

COMMMSE - Mass Storage Error Processor 



20.3 COMMON Decks Can Be Called in Three Ways. 

1. *CALL. 

If the program using a common deck is on a PL and the COMMON decks are on this PL 
or some other PL available to MODIFY, then the program can use the *CALL directive. 
See the MODIFY reference manual. 

Example. DECK1 is on PL MYPL and the COMMON decks are on OPL. 

JOB 

ACCOUNT 

GET, MYPL. 

ATTACH, OPL. 

MODIFY (Z)/*OPLFILE, MYPL/* EDIT, DECK1 

where DECK1 contains: 

*CALL, COMxnnn. 

2. XTEXT 

If the program is not on a PL then the pseudo op XTEXT can be used. The PL containing 
the COMMON decks must be available. 
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Example. DECK1 is not on a PL, but the COMMON decks are on the PL OPL. 

JOB 

ACCOUNT 
ATTACH, OPL. 
COMPASS. 
7/8/9 

IDENT DECK1 

OPL XTEXT COMxnnn 

END DECK1 

3. If the COMMON deck is executable code, and it has been assembled and placed on the 
system then the user can just external it and the loader will load it in with the user's deck. 
Example. 

IDENT DECK1 

RJ = Xnnn 

END DECK1 

Note that the entry point for all executable COMMON decks is the last three characters of 
the name. 

This method is of course limited to executable decks, which are a part of the system file. 
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ON-LINE DIAGNOSTIC ROUTINES 21 



21.0 INTRODUCTION 

The DSD command MAINTENANCE is the same as AUTO, but additionally assigns several 
maintenance routines at pool processor control points and CPU priorities (refer to the 
KRONOS 2. 1 Operator's Guide for more information on the command. . 

This section highlights each of these routines. In addition, a routine to test ECS is available 
from the SCOPE 3. 4 Operating System, but is not available with released KRONOS systems. 
This routine, EC2, compares ECS before and after multiple ECS read and writes. More 
information on the specific routines can be obtained from the SMM CE operators manual. 

21.1 CENTRAL MEMORY TESTER -MY1 

MY1 compares memory before and after a write/read. MY1 loads under SMM. The area to 
be tested is defined by the field length as found on the job card. AG is set to the field length 
and defines the upper limits. 

This test checks central memory by setting each location from 200 up to the field length to its 
relative value. It then does five read-backs of each location. The data read back is held in 
XI through X5 and is matched against X0, the current test address. It will accumulate and 
hold all the error bits in X7, store the error accumulations back into memory, read it up 
and check for zero. It also checks X7 for prior to storing. 

At the end of one sweep of memory, the test will then use the complement of the relative 
address and the check is repeated. 

In the event of an error stop, X7 will be holding the accumulation of error bits and X2 
through X5 should match X0. Either in the true state or complement form. If no error was 
indicated in XI through X5, the error occurred in XI and was lost when the accumulation 
check-read was done. If this is the case, the error bits in X7 equal the error bits that 
occurred in the first XI read. If the error loop is entered, a DCP entry and recall of the 
test is necessary to resume operations, or reset P to 3, automatic in KRONOS 2. 1. 
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21.2 RANDOM INSTRUCTION GENERATOR - RAN 

RAN randomly creates instructions, sets all memory references within FL, and runs the 
created job as a subroutine. RAN is a program that generates a set of lOg random num- 
bers, removes all the jump instructions from this set, and runs it as a subroutine. Passes 
are inserted in place of 30-bit instructions which occur in the last parcel. All writes and 
reads are restricted to specific areas. 

In order to check the results, a slow loop is also generated. This loop has the same 
instructions but contains only one instruction for every two words of passes. The B and X 
registers are loaded with random numbers and the A registers are set to known values 
before each pass. The slow loop is run first, the results of the registers stored, then the 
fast loop is run and the results compared. If the results compare, the fast loop is run and 
compared 14 more times. Providing no error occurs, the fast loop will have been run and 
compared 15 times for each set of random numbers before a new set is generated. 

When an error occurs, the loops will be shortened by one 60-bit word and the test rerun. 
If it still fails, the loops will be shortened again and the test rerun again and so on until 
the test doesn't fail. When this happens, the last word removed is replaced and the pro- 
gram halts. 

21. 3 DIAGNOSTIC MAINTENANCE - ADS 

ALS is the same as RAN, except its primary purpose is to test the stack registers and the 
Scoreboard's ability to handle instructions at a faster rate than that possible when not 
issuing the stack. ALX is a modified ALS which checks a "store after store" operation. 
ALS/ALX must not use a field length of less than 1500. 

Error detection is achieved by executing the same instruction sequence with the same initial 
register contents twice. The first pass through the instructions is terminated by an 04 jump 
instruction back to the beginning to achieve execution of all instructions from within the stack. 
The second pass is terminated by an 02 jump instruction back to the beginning to keep the 
instructions from being executed from out of the stack registers. Answers are compared 
and an error stop occurs if they disagree. 

Only 03-07 branch instructions are included since 01 and 02 instructions will not branch 
"in stack. " All jumps are to the current address plus one. The branch instruction/ 
instructions will get into the stack only if the branch is not taken on the first pass through 
the sequence. 

All increment reads and writes are to the same address in memory-address 000177. This 
address is cleared prior to the execution of the instruction sequence. 
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As part of the initial operands. Register Bl is preset to the loop count of 2 for execution 
of the instruction sequence. Register B2 is set to 000177 to be used as the increment read 
and write address. Neither Bl or B2 are used as result registers. 

21.4 MODIFIED VERSION OF RAN - FST 

FST is a modified version of RAN. The modifications include the optimization of all gen- 
erating and checking routines and the addition of a new option. Random instructions and 

operands used are the same as those used in RAN. FST will execute 347362ps passes in ■ 
1000g seconds compared to 23001 lg passes for RAN. 

The random number generator is at 240-247. The 10g numbers are saved at 340-347. 
Passes are inserted for all instructions which occur in the last parcel and for all branch 
instructions. All writes and reads are restricted to specific areas. 

A slow loop is generated from the fast loop instructions with only one instruction for every 
two words of passes. 

The B and X registers are loaded with random numbers and the A registers are set to known 
values before each pass. The slow loop is run first, the results of the registers stored, 
then the fast loop is run and the results compared. If the results compare, the fast loop 
is run and compared 31 more times. Providing no error occurs the fast loop will have been 
run and compared 32 times for each set of random numbers before a new set is generated. 

When an error occurs the loops will be shortened by one 60 -bit word and the test rerun, if 
it still fails the loops will be shortened again and the test rerun again and so on until the 
test doesn't fail. When this happens, the last word removed is replaced, the pass count 
entered in the dayfile, and the program halts. 

21.5 SIMULATOR -CT3 

CT3 simulates a randomly generated set of instructions. The simulator executing differ- 
ently than the machine loop constitutes an error. 

21. 6 CENTRAL PROCESSOR TEST 1 - CU1 

CU1 tests the central processor control hardware and the central processor functional 
units, etc. Test of the control hardware checks the real flat settings and the unit reserva- 
tions. The tests of the functional unit hardware check the arithmetic operations performed 
in the functional unit for a number, of fixed operands. 
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CU1 needs a basic field length of 10000. However, the last is for the branch unit and 
utilizes all available field length. If a greater field length is to be used, both A0 and the 
field length should be set to the new value. 
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CHECKPOINT - RESTART is composed of two CP routines, CHKPT and RESTART, which 
make use of the Special Entry Point (SEP) system described in Section 5. A user must be 
familiar with this system. The SEP allows these routines to access the privileged file 

DM*. 



By use of a control card call, macro call, or RA+1 request, the user can checkpoint a pro- 



gi 
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By using the RESTART control card, the user can restart a job from any point in the part 
that he previously checkpointed. 

All calls and the use of these routines are described in Section 11 of the KRONOS 2. 1 Refer- 
ence Manual. 

22. 1 CHECKPOINT FILE 

The checkpoint file is one long file, consisting of a series of checkpoint records. Each 
checkpoint dump is separated by an EOR, a checkpoint control word, and another EOR. An 
EOI terminates the entire file. A multi -checkpoint file is shown in Figure 22-1. 



CKP1 



Header Checkpoint Number (CKP) 1 



Data CKP1 



CKP1 Control Word 



CKPi 



Header CKPi 



Data CKPi 



CKPi Control Word 



CKPn 



Header CKPn 



Data CKPn 



CKPn Control Word 



Figure 22-1. A Multi-Checkpoint File 
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There may be one CKP or many CKPs on the file. If two files are defined, the CKPs will 
alternate on the files (refer to Section 11 of the KRONOS 2. 1 Reference Manual). The 
files must be requested with the CK or CB option on the REQUEST card, LABEL card, or 
the ASSIGN card. 

There are five parts to each CKP dump (one large record). 

1. The header word 

2. The file table 

3. A copy of each of the files requested 

4. A copy of the DM* file of the requesting job 

5. A control word (trailer label) embedded between two EORs. 

The file is written in control word blocks, using the READW and WRITEW macros. Buffers 
are always filled before transferring to disk, except for the final control word. Buffers are 
1000B words in length which is 10 disk PRUs or 1 tape PRU. Therefore, there are no 
short PRUs and no EOR, EOF, or EOIs except on the control word block. 

In order to indicate the EOR, EOF, and EOIs which occur in the data, a series of control 
words are used. These control words are: 

1. 10002B - header 

2. 20NNNB - file table 

NOTE 

The following control words indicate that an EOR, 
EOF, or EOI follows the nnn words of data. The 
3xxxx indicates that this is the file copy section. 

3. 30nnnB - Start of a block which contains no EOR, EOF, or EOIs. 

4. 31nnnB - An EOR occurs at the end of the next nnn words. 

5. 32nnnB - An EOF occurs at the end of the next nnn words. 

6. 33000B - EOI flag. No data may occur directly before this flag. 

NOTE 

The following control words indicate that an EOR, 
EOF, or EOI follows the nnn words of data in the 
DM* file. 

7. 40nnnB - Start of a block which contains no EOR, EOF, or EOI. 
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8. 41nnnB - EOR flag 

9. 42nnnB - EOF flag 

10. 43000B - EOI and end of DM* file 

11. 50000B - End of CKP dump 

Each CKP dump is one record followed by a control word. Each block on the file is nnn+1 
words in length, where nnn is the number of data words preceding this indicator. The 
maximum physical block size is 100GB words or 777B+1 words, nnn will vary due to EOR, 
EOF, and EOI occurring in the data. Figure 22-2 shows the format of one CKP file. 

The following 15 steps define entries shown in Figure 22-2. 

1) date - date CKP file was written 

2) time - time CKP file was written 

3) CKP mode - is the CKP file a CK (single) or CB (both) id type file 

4) CKP number - sequential number of this CKP. I.e., first time CKP called is 1, 
second time is 2, nth time is n. 

5) jobname - job name of job requesting CKP 

6) filename - name of a file to be checkpointed 

7) WW - job origin or control code from FNT 

8) file type - FNT file type, i.e., INPUT, LOCAL, PERMANENT, COMMON, 
OUTPUT, PUNCH, etc. 

9) copy type - portion of file actually copied, as discussed in Section 11 of the 
KRONOS 2. 1 Reference Manual. Unless otherwise specified by the user, files 
are copied according to their position and type of operation (read or write) 
prior to the CKP request. The codes are: 

- BOI to present position 

1 - present position to EOI 

2 - entire file 

3 - unused 

4 - no copy of file on CKP file. 

10) id - from FST 

11) eq - from FST 

12) first track - if mass storage, then from FST 

if tape, then = "MT" 

13) XX - or current track 
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FNT/FST 
entry 



FNT/FST 
entry 



18 



18 



12 



12 



J I!. 



12 



12 



{ 



10002B 



date 



time 



jobname 



CKP 



CKP 



mode number 







20NNNB 



filename 1 



id 



eq 



first track 



XX 



WW 



YY 



file 
type 



copy 
type 



ZZ 



'HEADER 



{ 



filename n 



id 



eq 



first track 



XX 



WW 



YY 



file 

type 



copy 

type 



zz 



30NNNB 



file 1 data 



33000B (EOI) indicator 



30NNNB 



file 1 data, etc. may extend over many blocks 



;>-FILE TABLE 



< 



33000B 



30NNNB 



file n data 



copy of files 
requested in 
order of the 
FILE TABLE 
smay be many 
' blocks of data 



33000B 



40NNNB 



copy of the DM* file 



43000B 



50000B 



X 



date 



time 



CKP 
mode 



CKP 

number 



<-. end of 



CKP 



Leor 
J CONTROL word 
/m identical to word 
Ceorl 1 of HEADER 

next CKP file 



! Bit X is set if this is the last CKP dump on the file and will be followed by an EOI PRU. 
X is in bit 59. 

Figure 22-2. CKP Format 
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14) YY - current sector, field length or format 

if tape, then XXYY = block number 

15) ZZ - last status from FET 

NOTE 

10 through 15 are standard FST, except for 
MT and block number. 

Figure 22-3 illustrates how the checkpoint file looks assuming a job has the following char- 
acteristics: 

1) FL = 2600B, CPA = 200B. So DM* file consists of 200 (CPA) + 4 (FNT/FSTs) + 
2600 (FL) = 3004B words. 

2) Two files imply 4 words of FNT/FST information. 

File 1 consists of: BOI, 1500B words, EOR, 100B words, EOF, 2001B words, 
OER, 170B words, EOR, EOF, EOI. 

File 2 consists of: BOI, 100B words, EOR, 1000B words, EOR, EOI. 

3) Assume this is a non-terminal job. 

22. 2 CHECKPOINT - CKP 

CHKPT is a CP routine which must reside either in the RCL or be disk resident (CLD - 
System). CHKPT can be initiated either by an operator command, a control card call, a 
macro call, or by a SCOPE 3. 4 product set call (See Figure 22-4). 

CHKPT has special entry point status. (Refer to Section 5. ) CHKPT uses the following 
SEPs DMP=, SSJ=, andRFL=. 

If CHKPT is called by a control card, 1AJ will find that it has an SSJ=, and a DMP= entry 
point. 1AJ sets up SPCW, SEPW, and the CPA. IRO is called to create the DM* file. 
Since DMP= is equivalenced to zero in CHKPT, all of central memory is saved on DM*. 
1AJ places the arguments from the control card into RA+ARGR and sets RA+PGNR 
accordingly during the load of CHKPT. Then control is passed to CHKPT. 

If CHKPT is called by a macro, an RA+1 request is made to CHKPT. This request is 
handled by SFP. Therefore, it is necessary for SFP to be an entry point in CHKPT. (See 
Rule 4 from the flow of an SEP request, Section 5. ) 

If CKP is called via a SCOPE 3. 4 product set, such as FORTRAN or COBOL, an RAM 
request is made and the parameter list, if one is specified, is set up the same as in the 
macro call. 
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(All values are in octal) 



Block 



1 




2 




3 




4 




5 




10002 


start of 
file 1 


31511 


indicates 
EOR fol- 
lows 511th 
word. 

indicates 
EOF fol- 
lows 100th 
word. 

no EOR or 
EOF in 
this block. 


30777 




31617 




31010 




CKP #1 


data 




data 


data 




•job name 


32000 




20004 


33000 


/start 


file 1 FNT 
FST 


31100 


w 


32100 


data 


(file 2 


file 2 FNT 


data 


30157 




FST 


data 




30767 




data 


30163 


30662 




data 







31115 



data 



33000 



41404 



data 



40255 



start of 
DM* 
file 400 

words +4 
words of 
FNT/ 
FST info 

start of 
FL 





41325 



43000 



50000 



CKP #1 



10002 



CKP #2 



etc. 



— end of DM* file 

— EOR 

— EOR 



DM* file is identical to standard rollout file. See Section 5 for DM* file format. 

Figure 22-3. Checkpoint File Structure 

The RA+1 request is processed by CPUMTR, which places the call into the IR of some 
available PP. 

r __ 12 18 

! I F5 i r 

IR = 



CKP 



CP 

number 



where: n = number of parameters 
PBA = FWA of parameter list 



PBA 
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® 



cjhKi-'t 



-CHECKPOINT - Snapshot 



CHKPT File 



-CHECKPOINT - Snapshot 



-CHECKPOINT - Snapshot 



(2) Make CKP request 
CHKPT - DMP= 



Progr 
makes call 
to CHKPT 



A+J. 






Program 


*1 


Call 
CHKPT 









-«-<^SFpJ) 



DM* 



Rollout 
File 



(3) CHKPT running in users 
FL creates CKP file 



FL 





FL 



@When CHKPT ends 1AJ calls 1RI in response 
to DMF = SEP and user continues 




1 - creates an RA+1 call. 



Note 

Refer to Figure 22-7 
for RESTART. 



Figure 22-4. CHECKPOINT Overview 
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Since PP resident does not find CKP in either the RPL or in the PLD, it calls SFP. 

SFP finds CKP as one of its special processors. The SFP overlay 2SG (SRP - Special 
Request Processor) sets up SPCW from the IR. 



18 


1 


1 


1 


1 


2 




12 




18 


CKP 
















PBA 



SPCW = 

SFP exits normally and 1AJ finds SPCW set. It loads CHKPT, which has the entry point 
CKP, and sets RA+PGNR=0 to indicate a non-control card call. Since a DMP = SEF has 
been indicated in the CLD, 1AJ calls 1RO. 

1RO finds the PBA not equal to zero and gets a 20B word block from central memory whose 
FWA is PBA. It creates a full DM* file and then stores the 20B word block in RA+SSPR+1 
through RA+SSPR+20. 1AJ sets up SEPW, and any priorities indicated by the SSJ= (in the 
case of CHKPT, there are no special priorities), stores the IR in RA+SSPR, and passes 
control to CHKPT at the entry point CKP. If more than a 20B word parameter is passed 
(CHKPT can be passed up to 200), CHKPT has to read it from the central memory portion 
of DM* . 

CHKPT sets up the CKP file using the DM* file. The SSJ= SEP is superfluous for CHKPT, 
since SSJ= equals SSJL and SSJL is a 5-word block of zeroes. CHKPT does not require 
any special priorities, extra FL, or privileges, except access to the DM* file. If the time 
limit runs out, CKP will be aborted. It is up to the user to ensure that the time limit is 
adequate for all his needs, including checkpoint time. 

Note that the preset routine in CHKPT is overlayed by the buffers, since it ORGs at 
IBUF. In addition, RFL= is equated to the last word of CHKPT, which is necessary for 
an SEP using the SSJ= entry point. 

Table 22-1 lists some of the common decks used and the buffer assignments. 

Figures 22-5 and 22-6 are flowcharts detailing the CHKPT main loop and preset routine. 
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TABLE 22- 



CHKPT BUFFER ASSIGNMENT/COMMON DECKS 



Load 






Address 




Common Decks 


662 




CTEXT COMCCDD - Constant to decimal display code 

conversion 


674 




CTEXT COMCCIO - I/O function processor 


706 




CTEXT COMCCPM - Control point manager processor 


712 




CTEXT COMCDXB - Display code to binary conversion 


727 




CTEXT COMCLFM - Local file manager processor 


740 




CTEXT COMCMVE - Move block of data 


757 




CTEXT COMCRDO - Read one word 


1002 




CTEXT COMCRDW - Read words to working buffer 


1116 




CTWTCT /" , i~miT/->o-vo _ r>_„««^™ „ * j. 


1150 




CTEXT COMCWTO - Write one word 


1166 




CTEXT COMCWTW - Write words from working buffer 
Buffer Assignments 
USE BUFFERS 


1270 


BUF 


EQU * 


2270 


IBUF 


EQU BUF+BUFL 


4271 


OBUF 


EQU IBUF+IBUF L 


6272 


SBUF 


EQU OBUF+OBUFL 


6673 


TBUF 


EQU SBUF+SBUFL 


7674 


RFL= 


EQU TBUF+TBUFL 



22. 3 RESTART 

RESTART is a CP routine which must reside either in the RCL or be disk resident. Where- 
as CHKPT writes DM* onto the CKP file, RESTART restores the contents of the files 
copied to the CKP file and causes 1RI to restore the CPA and FL from the DM* file, (see 
Figure 22-7. ) 

RESTART has the SEP DMP=. When 1AJ loads RESTART, it notes that SEP is active from 
the CLD or RCL entry point word with the SEP (bit 59) set. It calls 1RO which will create 
a DM* file. Since DMP= is equated to 45000B in RESTART, it creates an empty DM* file. 

12 

Therefore, DA = R|o s|c[f|u J FL | where: r = i RESTART roll -in 

C = 1 Create empty DM* file 
U = 1 Create DM* as an unlocked file 
FL = is ignored since bit C is set. 
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PRS 



Preset 
Program 



RECALL 




HDR 



Avrite header 
.onto CKP file 



WRT 



write FILE 
TABLE onto 
\ CKP file 



CPF 



'copy desired 
files to 
CKP file 



set file 
name to FET 
to DM* 



Entry: DM* file exists and contains control 

point area, FNT/FST, and field length. 



© 



REWIND 
DM* 



BLO 



Process 
of CKP 



copy DM* 
file to CKP 
file 



end file 



place 
.50000B in 
buffer 





place 

CKP CON- 
TROL word 
in buffer 



*4 



WRITER 
CKP file 




set 

completion 
bit in param- 
eter table 



RETURN ! 
control 
statement 
file 



CHECKPOINT 
COMPLETE 



c 



END RUN 



J 





: 1 Wait for any I/O initiated by PRS to complete. 

= 2 Use GETFNT macro which calls LFM to return a list of all FNT/FSTs assigned to this 
control point. 

; 3 See DMP= in Section 5. 1. 2 SEP. Format of DM* file is CPA, FNT/FST, job field 
length. Copy complete DM* file. 

'4 Copy of header word and only word in the buffer. 

■5 Now CKP control word is embedded in EORs. 

= 6 SPRR+1 also backspace file so trailer can be read by next CKP call. 



Figure 22-5. CKP - CHECKPOINT (Main Loo:>) 
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SKIP I 
DM* 



read 

last 

record 



process 

parameter 

list 



set 

corrective 
CKP FLAG 
RA+SPFL =d 



process 
rest of 
parameter 
list 





n from IR) not equal 0? 



: 1 Is (RA+PGNR) not equal zero? 

■2 Is (RA+SPPR) lower 18-bit (i.e. 

: 3 Is n > 20. 

; 4 Parameters = file names are placed in block PAR for use by WRT and CPF to get just 
selected files onto CKP file; only 77B parameters are allowed. 



Figure 22-6. PRS - CHECKPOINT (Preset) 
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Set 

selective 
CKP flag 
RA+SPFL=n 



process 

parameter 

list 




*2 




preset all 
pointers 





get 

control 
statement 
file 



get list 
of all FNTs 
assigned to 
this CP 



create 
default 
file 

cccccc 




get proper CKP 
file set up for 
write and posi- 
tion file. Set 
FETs up. 



c 



RETURN 



J 



* 1 Is RA+ACTR not equal zero. 

*2 Maximum 63B parameters on a control card. See footnote 4 on previous page. 

*3 See if any files local to job have type CK or CB. 



Figure 22-6. PRS - CHECKPOINT (Preset) (Continued) 
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(7) RESTART is a 
control card call 




Load RESTART into users FL 



(?) RESTART builds DM* 
Vw/ file from CHKPT file 




(?) RESTART ends and 
1AJ responds to DMP= 

*** _FL *1 



PROGRAM 



O 



Execution begins at next 
instruction after the call 
to CHKFT. 



PROGRAM 



CALL 
CHKPT 



* 1 - This is the same area as 
RESTART of Step 2. 



Figure 22-7. RESTART Overview 
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1AJ sets up CPA, SEPW, SPCW, etc., loads RESTART, stores the argument list in 
RA+ARGR, sets RA+ACTR accordingly, and initiates RESTART. RESTART cannot be 
called from an RA+1 request, so the parameter passing ability of DMP= is not utilized. 
RESTART locates the proper CKP file, requests the FL required, restores the files re- 
quired (including the DM* file from the CKP file), and exits. 

1AJ then finds the control point idle and notes this was a DMP= run. 1AJ will call 1RI, 
which rolls the job in using the DM* file created by RESTART. When 1RI is done, it clears 
the rollout flag, and the job is restarted from its position prior to checkpoint. 

As in CHKPT, the preset routine is used as a buffer so that core is minimized. Table 22-2 
lists some of the common decks used and the buffer assignments. 

Figures 22-8 and 22-9 are flowcharts detailing the RESTART Main Loop and Preset Routine. 
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TABLE 22-2. RESTART BUFFER ASSIGNMENTS /COMMON DECKS 



Load 
Address 



602 
626 

641 
655 
661 

676 

722 

732 

742 

754 

776 

1112 

1124 

1155 

1173 



1300 
2301 
4302 
6303 
6704 
7707 



Common Decks 



CTEXT COMCARG - Process arguments 

CTEXT COMCCDD - Constant to decimal display code 

conversion 

CTEXT COMCCIO - I/O function processor 

CTEXT COMCCPM - Control point manager processor 

CTEXT COMCDXB - Display code to binary conversion 

CTEXT COMCEDT - Edit date or time from packed 



CTEXT COMCLFM 
CTEXT COMCPFM 
CTEXT COMCRDC 
CTEXT COMCRDO 



format 

Local file manager processor 
Permanent file processor 
Read coded line, -C- format 
Read one word 



CTEXT COMCROW - Read words to working buffer 
CTEXT COMCSFN 
CTEXT COMCSYS 
CTEXT COMCWTO 
CTEXT COMCWIW 

Buffer Assignments 



Space fill name 

Process system request 

Write one word 

Write words from working buffer 





USE 


Buffers 


BUF 


EQU 


* 


IBUF 


EQU 


BUF+BUFL 


OBUF 


EQU 


IBUF+IBUFL 


SBUF 


EQU 


OBUF+OBUFL 


TBUF 


EQU 


SBUF+SBUFL 


RFL= 


EQU 


TBUF+TBUFL 
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*1 



REWIND 

DM* 
\ file 



*2 



get memory 
from CPA 
on CKP file 



*3 




MEMORY 
CM, FL 
request cen- 
tral memory 



* 4 



copy rest of 
CKP file to 
DM* file 



position CKP/ 
file for sub- 
sequent 
CKP 



RESTARTED 
from "job- 
name date & 
time* 



*6 



© 

: 1 Copy all data files from the CKP file. 

■2 Prepare to write remainder of CKP file onto the DM* file. 

: 3 Exchange' package in first 20B of CPA and word CPA+2is FL. 

: 4 If job card FL request is less than FL needed to RESTART, control point would be 

aborted by CPUMTR. 

: 5 Stop on EOR. 

; 6 Message set up by preset. 



Figure 22-8. RESTART - RESTART (Main Loop) 
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Set CKNO = 
RA+ARGR+1 




get 
jobname 



ARG 



process argu 
,ment Common 
deck 

:omcar 




place data and 
time into mes- 
sages issued 
at end of run 



RETURN 



3 



Is (RA+ACTR) not equal zero. 

RESTART must have an argument list. 

Is (RA+ARGR)=0. 

(RA+ARGR)=CKP file name. 

Is <RA+ARGR+1) = 0. Note that CKNO is preset to at assembly. 

Is (RA+ARGR+2) = 0. 

The error CHECKPOINT FILE error if header word missing or CHECKPOINT NOT 

FOUND if asked for a CKP number that is not on the file. 



Figure 22-9. PRS - RESTART (Preset) 
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23 . INTRODUCTION 

When programming at the CP level, the system programmer has many debugging aids at 
his disposal. Among them are KCL, relative core dump macro and control card* DIS, 
and KRONREF. However, when programming at the PP level, the system programmer has 
fewer debugging aids (KCL, DIS, and deadstart dumps) . 

This section discusses the debugging aids available. At the end of this section is a listing 

of four useful debugging programs that are only available in this document. j 

23. 1 KCL AND PROCEDURE FILES 

KCL gives the user great versatility in coding a control card stream. The user can cause 
a job to execute in many different ways based on some selection criteria If a job sets 
a fatal error flag, the user may regain control by having an EXIT card in the control 
stream 

KCL also has an extremely useful feature called procedure files. These can be used to 
good advantage while debugging a job, or even for some multi-task operations. The KCL 
descriptions and the procedure file description is given in Section 4 of the KRONOS 2 1 
Reference Manual. 

23.2 DOCMENT CARD 

Internal and external documentation is contained in the listings of most of the programs on 
the system. By the use of the DOCMENT control, this documentation can be dumped to a 
printer. Page 31 of the KRONOS 2. 1 Reference Manual describes how to use this card. 



23.3 DISANDQIS 

Debugging also can be done by use of DIS. DIS gives the facility of breakpoint and 026. 

These commands and features are discussed in the KRONOS 2. 1 Operators Guide and in the 
KRONOS 2. 1 Instant Manual. 

QIS is a remote terminal DIS device. This hardware is not normally supported by KRONOS 
2.1. However, software has been written to use this device. The software is not supported 
and not normally available. The CMR entry and binary EST entry for this device is: 



97404700B 23-1 



I 



EQxx = SC, St, eq.un.ch. 
EST entry = OOpp OOcc 0000 2303 eOuu 
where pp is CP number assigned to = 0. 
cc is channel number 
2303 is SC in display code 
3 is equipment number 
uu is unit number 

23.4 DEADSTART DUMPS 

The process to obtain deadstart dumps is detailed in Part II, Section 3 of the KRONOS 2 . 1 
Installation Handbook. Part IV, Section 4 of the KRONOS 2. 1 Installation Handbook 
details how to use the utility DSDI to format the express dump obtained using the deadstart 
F option. 

23.5 FOUR USEFUL ROUTINES 

The following four routines are described in the beginning of their code . The listings 
are shown in Figures 23-1 through 23-5. 

23.5.1 

Since the DUMP routines in KRONOS will not allow any CP user to dump absolute memory, 
the following routine was written (Figures 23-1 and 23-2). It consists of a CP routine 
which calls a PP routine. They will dump absolute memory as specified on the call 
card to the program. The user must SYSEDIT the PP program onto the system (Job 1) 
then run Job 2 The dump parameters are specified on the LGO card as follows. LGO 
(from field, to field) . The dump will start at the from field and terminate one buffer 
beyond the to field . Illegal parameters are flagged in the listing. An example of some 
dumps are given at the end of the listings. Note a macro CKIR has been defined in TLP. 
This macro can be copied and used by any PP programmer who would like a way to unhang 
his PP during debugging. Used in the code at WAIT, the PP hangs while waiting for the 
CP program to respond. If the CP program cannot respond, the operator can cause the 
PP program to drop by changing the PP name in the IR in CMR from the console. When 
the PP has dropped, the CP program can be dropped by the drop command. 

23.5.2 

KRONOS 2 1 has no facility for register snap shots which will keep all the registers 
intact. The user can use the macro SYSTEM DMP, R, but X6, A6.A1, and XI are destroyed 
and the macro makes a call to the system which has to load CPMEM. When control is 
returned to the user none of the registers can be assumed to be the same as before the 
call. 
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The following routine REGDMP (Figure 23-3) is loaded as a local routine and can be 
jumped to with out the system intervening All the registers are dumped intact to the 
printer and when control is returned to the caller, all the registers are intact. Hence, 
this routine can be called indiscriminantly for debugging purposes In addition it prints 
the address it was called from. The call is RJ = XREGDMP. 

Also, entry points LOADEM and SAVEM can be used to save the registers and restore 
them at some later date. Note that a call to SAVEM will destroy the contents of the 
registers, but LOADEM will restore them, and can be used to restore them any number of 

times Any new call to SAVEM will reset LOADEM. The call is RJ = XSAVEM and RJ 
= XLOADEM. 

JOB 1 will create a binary deck of REGDMP. 

23.5 3 

Figure 23-4 is an example of a CP routine using special entry points It also demonstrates 
the use of monitor function "RSB" which is used here to read the Equipment Status Table 
(EST). 

23.5,4 

Figure 23-5 a PP routine, will dump any track of any mass storage device to the printer 
and does not require an FNT/FST entry 
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iLP.TLP 



COMPASS 3.73309. 



7I./03/08. 2l.ii6.03. 



PAGE 



to 

CO 



TLP, CM50000, T7777. 
ACCOUNT, MLO, . 
COMPASS. 

SYSEDIT. 

7/8/9 niulttpunch EOR indicator 



IDENT TLP, TLP 

PERIPH 

SST 

XREF A 

PP PORTION OF ABSOMP ROUTINE 
CONTROL DATA CORPORATION 
M. L. OHHERMAN 



ROUTINE 



TO DUMP ABSOLUTE CORE WITH DISPLAY VARIABLES 
USING CP ROUTINE TALKPP FOR OUTPUT BUFFER 



♦T 



IN CP ROUTINE 



OPL 



PP IR 
IR = 18/TLP,Z<»/D,1B/PPP 

PP ROUTINE IR = TLP0000PPP 

WHERE TLP IS PP NAME 
PPP IS ADDRESS OF AUTO-RECALL H0RO -PPOONE- 
PPP = 2<i/FFF,18/0.18/TTT 
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Figure 23-1. Job 1 
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Figure 23-5. DPR-PIM-'W Head Specific Sector 



DEADSTART 24 



24.0 INTRODUCTION 

The KRONOS operating system consists of PP programs, CP programs, macro definitions, and 
symbol definitions. The entire system is contained in a magnetic tape file produced by the 
library maintenance routine MODIFY. Programs in the library file are in source language form. 
Installation options are provided to permit flexible selection of system features during the 
assembly and creation of a deadstart file on tape. 

The deadstart (DS) tape is a collection of binary files created by the library maintenance routine 
LIBEDIT. The DS tape is used to start up a CDC CYBER 70 or 6000 Series computer and load 
the KRONOS operating system. 

To load the operating system into a CDC CYBER 70 or 6000 Series computer, the DS tape is 
mounted on a device (magnetic tape drive) , and a small bootstrap loader program is set up on 
the hardware deadstart panel switches. The deadstart procedures are explained in Part II of 
the Installation Handbook. 

24.1 HARDWARE DEADSTART 

When the operator hits the DS button, the following occurs: 

1) The DS panel (Table 24-1) is input across channel into PP0 locations 1 through 14. 
The DS controller will output 1 byte of zeros and then the DS panel to PP0. It then 
issues a DCN and PPO begins executing at loc (P)+l = 0+1 = 1, PP0 is ready to 
perform an IAM at DS. 

2) Each PPU except PPO is connected to its corresponding channel (i.e. , PP1 
connects to channel 1, PP2 connects to channel 2, etc.). 

3) Channels 0, 12, and 13 are not connected (that is why the tape channel is wired as 
channel 13). 

4) The (A) of each PP is set=10000B so that a ?? can input Its entire field length before 
automatically disconnecting from the channel. 
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5) Each PP will hang on an IAM on Its channel. This simulates the PP contents bytes 
0, 1, 2, and 3 as follows {See figure 24-1): 

0000 start at location P+l = 1 

1 1S00 LCN set (A) = 777777 

2 71pp IAM pp number = channel number 

3 0000 at location 

In actuality, the hardware will set (A) = 10000, and place the PP in TRIP 4 mode 
of the IAM instruction'. Bytes 1,2, and 3 are not destroyed. 

When a PP dump is requested, the following 4 bytes are sent to the PP. 

0000 start at location 1 

1 1500 • LCN set (A) = 777777 

2 73pp OAM pp number = channel number 

3 0000 output on channel pp all of PP memory. 

Thus bytes , 1 , 2 , and 3 are lost in the dump , 
Figure 24-1 Is a description of the IAM instruction, 

6) PP0 will begin executing at location 1. 

7) The CPU will do a hardware Idle . 

When the IAM begins, (P) is stored in location 0. As each 12 -bit PP word is transmitted 
across the channel, (A) is decremented by 1. Whenever (A)=0 or the channel is disconnected 
by another PP or a controller, the receiving PP will store (0)+l into (P) and execution begins at 
the location thus formed. This property is used to autoload routines. A PP will IAM a set of 
words and then input as the final word an execution address minus one into location zero. The 
?? will then begin executing at the execution address specified (see SFP in PP resident 
Section 4) . PPs may communicate with a piece of hardware via a channel or with another PP 
via a channel. If a PP communicates with some hardware, it must set its (A) to the number of 
words it wishes to input. When this number of words has been input, it will execute at {0)+l. 
If two PPs are communicating when the transmitting PP does a DCN on the channel, the 
receiving PP will begin executing as if (A) went to zero. 
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TABLE 24-1. DEADSTART PANEL 



Location 


Binary 


PP COMPASS 


Description 


I 


75 13 


DCN 13 


disconnect channel 13 


2 


77 13 


FNC 13, eOOu 


function on channel 13 


3 


eO 0u 


eqe Unit u 


equipment e unit u 


4 


77 13 


FNC 13,0010 


function on channel 13 


5 


00 10 


rewind code 


rewind 


6 


77 13 


FNC 13, 1400 


function on channel 13 


7 


14 00 


select input to 
eor 


select read to eor 


10 


74 13 


ACN 13 


activate channel 13 


11 


71 13 


IAM 13,6606 


input from channel 13 


12 


66 06 


load address 


to PP loc 6606 


13 


OXXY 


- 


see Part II, Section 2 of 

the Installation Handbook 


14 


RPSS 


— 


see Part II, Section 2 of 
the Installation Handbook 



24. 2 SOFTWARE DEADSTART 

This section describes both the Phase I deadstart and Phase II system activation. 

24. 2. 1 Phase I Start Up 

When the hardware is ready, PP0 will begin executing the program on the deadstart panel. 
Refer to Table 24-1, Figure 24-2, and the system catalog in Section m of the 
Installation Handbook. 

1) PP0 will disconnect channel 13 (clear it), then connect (via function) to channel 
13, equipment e, unit u, and rewind the DS tape. It will then read the first 
record from the DS tape into its memory starting at location 6606. This 
record is the binary deck PRL "system tape preloader. " PRL is 1053B bytes 
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NOTE 
This instruction will hang up the Peripheral Processor if executed when the channel is 
inactive . 

71 1AM md Input (A) words to m from channel d (24 Bits) 



f 



I. 



25 
V 



18 17 



12 11 
— * V— 



(P) 



CP+1) 



This instruction transfers a block of 12-bit words from input channel d to the processor memory. 
The content of A gives the block length. The contents of location m specifies the processor 
address which is to receive the first word. The content of A is reduced by one as each word is 
read. The input operation is complete when A = or the data channel becomes inactive. If 
the operation is terminated by the channel becoming inactive, the next location in the processor 
memory is set to all zeroes. However, the word count is not affected by this empty word. 
Therefore, the contents of the A register gives the block length minus the number of real data 
words actually read in. 

During this instruction address 0000 temporarily holds P, while m is held in the P register. 
The content of P advances by one to give the address for the next word as each word is stored. 



Figure 24-1. The IAM Instruction 
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FORMAT: 










(P) 


F 


d 




71 


channel 

# 


(P)+l 


m 


PP byte address 



F = Operation Code 
d = Channel Number 
m = PP Memory Address 

A Register Preset with Word Count 



TRTP 1 



K = 000 



READ Fd PORTION OF INSTRUCTION 
FROM LOCATION (P) 

F K REGISTER 

d — — Q REGISTER 
(P) + 1— P REGISTER 



TRIP 2 



K= 710 



STORE (P) AT LOCATION 0000 B 
0Q + 1 -K REGISTER 



TRIP 3 



K = 711 



READ m PORTION OF INSTRUCTION 
FROM LOCATION (P) AND PLACE 
IN THE P REGISTER 
(K) + 1—— K REGISTER 




STORE CHANNEL 
REG. CONTENTS 
AT LOCATION (P) 
(P) + 1— P REG. 



(A) = 1? 



D/S sets 



"XA) = 10000B 



(A) - 1 

A REGISTER 



1- 



(A) 

A REGISTER 



(K) + 1--K REG. 



T 



TRIP 5 



K = 713 



READ CONTENTS OF 0000 , ADD 1 , 
AND PLACE IN P REGISTER CLEAR 
K REGISTER 



v_ 



Figure 24-1. The IAM Instruction (Continued) 
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DEADSTART - PHASE 1 - START UP 



System Tape 
Preloader 




Deadstart Tape 

(System Library - Binary 

Piles) 




DEADSTART - PHASE 2 - SYSTEM ACTIVATION 
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Figure 24-2. DS Taoe 
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DEADSTART 
PHASE II 



CM 



PP NO. 



PP ROUTINE 



CPUMTR 



o 




a. 
b. 

6. 

d. 
e. 
f. 
9. 
h. 

i. 
]. 
k. 
1. 
in. 
ZAP. 



DESCRIPTION 

SET load PPR and STL Into PP2. 

STL loads PPR Into all PPs 
except PPO and PP1 . 

Load MTR Into PPO. 

Load and initialize CPUMTR. 

Load DSD Into PP1. 

Load MS drivers into RPL. 

Load RMS to PP3. 

Load SLL to PP4 if system tape 
load required. 

Disconnect CRO and activate MTR. 

Activate all other PPa. 

If 844s on system load firmware. 

Load LSL into PPS. 

Load SYSEDIT into CP1 . 

Activate CPUMTR with an exchange 
Jump. 



Figure 24-2.1 Phase I Deadstart Startup 



o 

o 
o 

o 




@ SYSEDIT reads the SYSTEM 
tape and copies directly 
to each system RMS device. 

(b) Build the RPL, PLD, RCL, 
and CLD via the PP routine 
LSL. 

(c) Set MSTs from RMS labels 
and recover TRTs when 
possible and verify PF 
configuration. 

(d) Load REC into this PP. 

(e) Read SYSTEM tables and 
recover or create FNT, 
CPAs, etc. 

(tj After point a has completed 
(SYSTEM FST byte 4 goes 
non-zero) recover DA 
files, and issue dayflle 
message, 

(g) Load 1CK into this PP to 

perform a CHECKPOINT SYSTEM. 

(h) Load 1TD Into this PP if 

TELEX recovery necessary, 
else drop. 

(T) DSD processes the IPR 

commands DSD,n,^ : . 



Figure 24-2.2 Phase II System Activation 



in length. It is preceded with a 77 table (a loader table) which is 120B bytes long. 
Hence the total length of PRL is 1173B. Since the load address of S606 was specified 
on the deadstart panel, the last two bytes loaded into PP memory are at location and 1, 
That is, 

Word Value 

PRL-1 = 6725 

1 garbage 

When the controller senses EOR, the tape channel is disconnected and PPO begins 
execution at (0)+l or S725+1 = 6726, Indeed, 6726 is the first executable instruction 
in PRL. 

2) PRL checks word 13 for options. If word 13 is equal to 1 , PRL inputs record two, routine 
2PR, as an overlay to itself. 2PR is loaded starting in location 6606 and covers the code 
PRL has executed to this point. 2PR is a collection of tables and display fields. 

3) PRL must connect to the operator's console to display the DS options. Normally, the 
console is wired to channel 10, but PP10 is connected to channel 10, therefore, PRL 
must release channel 10 from PP10. PRL therefore transmits across channel 10 the 
three bytes CON0;LCN 0; IAM 0,0;. and disconnects the channel. PP10 will input 
these bytes into locations 0,1, and 2. The controller will transmit one byte of zero 
into location 3, i.e. , 

byte 
0-0 

1-LCN 

2 -IAM channel 
3-0 set by hardware OAM 3 bytes 

The IAM will complete when PPO disconnects the channel. PP10 will begin executing 
at location 1 which will set (A)=7777B, and hang on an IAM at channel 0. New that 
channel 10 is free, PRL will connect it. 

4) PRL will display the DS options and accept'operator input.' If any of the diagnostics 
are selected, PRL will input the appropriate routine (one of the next six records on 
the tape) into PPO and start executing them. The operator must press the DS button 
to exit the diagnostics which starts the DS sequence over again. If none of the 

I diagnostics are chosen, he hangs PP10 on CH10 with the three bytes CON 0; LCN 0; 

IAM 0,10, then he skips 6 records and inputs record 9, SET. There is no need to 
check program names since the DS tape sequence is fixed. He strips the 77 table and 
loads SET beginning at location 0. The first word of SET is a constant = FWA-1 of SET. 
Therefore, when the IAM completes, SET will begin executing in PPO. 

SET initializes the system configuration by assembling system parameters such as equipment 
definitions and installation options from text decks on the deadstart tape. PPR and STL are 
read and passed to PP2. STL is started and SET prepared to input MTR. 

| When SET begins executing in PPO, PP10 is hung on CH10. 
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1) SET will transmit via CH10 an idler program to PP10 and disconnect CH10. 

2) PP10 will begin executing the idler program. 

3) SET will use CH10 to display the CMR/IPR DECKs and INSTRUCTIONS on the console. 
SET will also accept operator typeins via CH10. 

4) SET uses PP10 as a CMR/IPR DECK buffer while building the appropriate DECK from 
operator input, if any. 

5) SET communicates with PP10 via CHO. PP10 will read the appropriate CMR/IPR DECK 
trorn ui€ lJu *.sps vis lH<3 cSps Ciisnnsi* 

6) The PP10 processors are: 

processor routine 

value name 



RSP terminate 

1 IFP input first buffer ) from DS tape 

2 ISB input second buffer f C MR/PR DECK 

3 OFB output first buffer ) to SET via 

4 OSB output second buffer J CHO 

5 ONL output next line to SET via CH10 

6 ANL add next line to PP1 buffer 

7) When SET has completed both CRM/IPR DECK, it will issue the RSP function to PP10 
via CHO. 

8) PP10 will hang itself on CH10, i.e. , LCN 0; ACN 10; IAM 0,10. 

The sequence is: 

1) SET loads overlay CMR (next record on tape, see the system catalog), which has 
the processing code to make the changes to CMRDECK, reads up the text deck 
CMRINST (CMRDECK instructions), and reads up the specified CMRDECK. 

2) CMR will display the instructions or the CMRDECK and accept input from the 
console which is stored in a table. When the CMRDECK is changed to the 
operator's satisfaction, CMR will skip all text records and load the next 
record, which must be ICM, as a secondary overlay. 

3) ICM will build the CMR tables through the EST, when ICM completes, control 
is returned to SET. 

4) SET loads the next record, which is IPR. 

5) IPR will read IPRINST and the specified IPRDECK, display them, and accept input on 
the console if the last type-in from CMRDECK was NEXT. If it was GO, then 
IPRINST is skipped and no input is accepted. Now, IPR will set up the appropriate 
portions of CMR (MSCL, IPRL, etc.) and will set up all the other options specified 

in IPR deck. Now, IPR will return control to SET. I 
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6) SET will skip all remaining TEXT records and will load PPR (the first non-TEXT 
record) into his PP buffer. He sets the location (PP buffer - 1) = PRS-1. He then 
(OAM) transmits the buffer starting at PP buffer - 1 into PP2 on channel two. This 
puts PRS-1 into location of PP2. Now, SET will read the next record, STL into the 
same PP buffer. Then, SET will transmit the buffer to PP2. PP2 will input STL 
starting at location PPFW. SET then issues a DCN on channel 2. This will 
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PPR which then jumps to PPFW which is STL. PPO will hang himself with an IAM 
on channel 0. 



24,2.2 Phase II - System Activation (Figure 24-2) 
STL performs the following sequence. 

1) Load copy of PPR in all PPs except and 1. (See paragraph 24.3) (PPR + PRS is 
1077B words, thus at the end of this step each PP is IAM on location 1100B=PPFW). 
Also, the 1st byte transferred is PRS-1 (600) so in Step 9, control will be sent 

to location PRS (601) in each PP. 

2) Load MTR to PPO . 

3) Load and initialize CPUMTR. 

4) Load DSD to PP1. 

3) Load mass storage drivers to Resident Peripheral Library (RPL). 

6) Load RMS to next available PP (PP3) . 

7) Load SLL to next available PP if system tape is to be loaded (PP4). 

8) Disconnect channel which will activate MTR. Now, STL will use monitor 
requests. He immediately issues an RPPM request for PP2, PP3 , and PP4 
since they are busy. (Assume that PP3 and PP4 were the next available 
PPs above PPR). 

9) Activate all other PPs by transmitting LJM PPR and disconnecting their channels. 
(Note that each PP would store these two bytes at PPFAf and PPFW+1). 

10) If there any any 844s in the system, it loads firmware. 

11) Load LSL into next available PP (PP5). 

12) Load SYSEDIT from DS tape into CP1. Set up the exchange package and control 
point area. RA=location beyond where the CLD will be loaded and FL=rest of 
core. 

13) Rewind DS tape. 
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14) Execute an exchange jump (MXN or EXN) to start CPUMTR. 

15) Issues an RPPM request for PP2, PP3, and PP4 since they are busy. (Assume that 
PP3 and PP4 were the next available PPs above PPR). 

SYSEDIT, with the help of STL to read the DS tape and LSL to write the system onto the system 
MS device(s) performs the following sequence. 

1) Read DS tape and copy directly to each system device defined. (Used to make new 
deadstart tapes and for a catalog of the system file) . 

2) Reread the first system device as the following is performed. 

3) Build the RPL in CM, stripping off all 77 tables. 

4) Build a PPULIB file on each system device which is a copy of all PP routines not in 
the RPL stripping off all 77 tables and builds a PPULIB on any alternate devices 
defined while building the PLD and setting the track and sector pointers into the 
PPULIB file in a scratch area of central memory. 

5) Eliminate the FNT/FST for the PPULIB file. Now the only record of this file is the 
last track and sector of the system file, and the track and sector pointers in the PLD. 

6) Build the RCL stripping off the 77 tables. 

7) Move the scratch copy of the PLD into CMR. 

8) Build the CLD setting the track and sector pointers pointing into the system file. 
There is no separate copy of CM system programs created corresponding to the PPULIB. 

9) Exit via ENDRUN, which sets "W" , "X", and "R" status to 0. 

Additional system activation requirements and functions. 

1) If more than one device is designated as a system device, then: 

a) All system devices must be the same type. 

b) As SYSEDIT requests tracks, if one of the devices has an interlocked track, 
all other devices will not use this track. This ensures that the PLD, CLD 
can always point the same to all devices. 

2) While the system is running (beyond deadstart), a call to SYSEDIT will: 

a) Any new or replaced CP or PP decks, libraries, etc. , will be written 
starting at the end of the system file. 

b) A new PPULIB file is created from the system file. 
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the system file. 

d) At Deadstart Time SYSEDIT uses LIBDECK from the system file to determine which 
decks are CM resident and for all his directives. Each subsequent time SYSEDIT 
is called, a new LIBDECK is created appending the SYSEDIT directives to LIBDECK. 
These LIBDECKS are linked together so that SYSEDIT can recreate the PLD, CLD, 
RPL and RCL from an" earlier time if directed by SYSEDIT (R=n) . 

e) The alternate library directory resides at the beginning of the PLD. This forces PP 
resident to check alternate libraries first, and also provides a mechanism for 
quickly disabling access to them. 

While SYSEDIT is running in the CP, the following is accomplished in the PPs. 



RMS performs mass storage recovery in the following sequence: 

1) Set up MSTs from labels. 

2) Recover TRTs when possible, 
a. Verify PF configuration, 

3) Load REC into this PP. 

REC performs system recovery in the following sequence: 

1) Read system tables* 

2) Recover FNT, control points , etc. 

3) Wait for SYSEDIT, LSL, and STL to complete (byte 4 of system FST / 0). 
(Step 7, page 24-6). 

4) Recover direct access files (0 level only) from the disk catalog tracks and clear 
all DA interlocks, else from CMR. 

5) Issue dayfile messages. 

6) Load 1CK if checkpoint necessary (always on system load) into this PP. 

7) 1CK loads 1TD if TELEX recovery necessary into this PP. 



When SYSEDIT completes, LSL will issue a DPPM monitor request and jump to PPR. STL will 
issue an RSJM request (request scheduler) and jump to PPR. 

DSD, when activated earlier by STL, will process the IPRDECK initial commands - AUTO, 
MAI, AB, etc. 
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1SJ will find that CP1 has a status of zero and will release the control point. Since there is 
no output file, no output or dayfile message is issued. 

The system is now operational. All the DS load parameters and DS sequence descriptions 
are contained in the common deck COMSDSL. 

24. 3 PPR INITIALIZATION ROUTINE PRS 

When STL sends a copy of PP resident to each pool PP, the cells IA, OA, and MA are set 
correctly for this PP. When STL disconnects the channel, each PP will begin executing at 
PRS which is the resident initialize routine. PRS is at location 601B, 600B is set zero, 
so that PRS will be overlayed by the 1st MS driver, PRS will: 

1) Read PPCP the FWA of the PP communication area (actually IR for PPO). 

2) Get (IA) which is the address of this PP's IR. 

3) Subtract from it the IR of the PPO. 

4) Subtract from that one PP communication region = 10B. 

5) Multiply it by 2 IB to get the offset for the exchange package 

PP1 offset OB 
PP2 offset 2 IB 
PP3 offset 42B 
PP4 offset 63B etc. 

6) Read PXPP which is the address of PP1 exchange package. 

7) Add PXPP to this PP offset and get the address of the EP for this PP. 

8) Then he stores this address into XJ3 which is an LDC (EP address) and adds 
6 to get the address of EP+6 and stores that into XJ2. 

9) Determines if CEJ/MEJ exists and fixes up XJ1 accordingly. 

10) Set up the rest of the direct cells. 

11) Etc. 

12) LJM PPFW 

13) At PPFW is the instruction LJM PPR. 

14) The PP is now a Pool PP. 

24. 4 RECOVERY 

Deadstart recovery is an inhibition of part of the deadstart process. No special routines or 
special code is designed for different levels of recovery. The philosophy is that deadstart 
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is always a recovery and the levels only denote how much to recover and how much to reload. 
The following discussion pinpoints the process of each deadstart recovery level. 

0) Permanent files are recovered if possible from the labels of the MS devices. 
All of CMR, all of the system, and all of the PPs are reloaded. 

1) This level rebuilds the running system, ail jobs, and ali active fiies from the 
checkpoint file (any deadstart automatically creates a checkpoint file to start 
future deadstarts) instead of the deadstart tape. The FNTs are left intact. 
CMR is rebuilt, and all PPs are reloaded (use the CMR copy of MST for 

PF recovery) . 

2) The only difference between level 1 and 2 is that level 2 loads the system from 
the deadstart type. This is the method used for system test procedures. 

3) This level only loads the PPs; everything else is left intact. 

24.4.1 TRT Recovery 

At Level 0, all track chains in the TRT denoted as PF, or reserved as flawed in the label or 
specified in the CMRDECK are preserved, all other tracks are set clear. No other validation 
is performed. Level 1 and 2 are same as level except all files found in the FNT/FST are 
also preserved. In Level 3 no track chains are cleared. 

24.4.2 More information is contained in the Installation Handbook in the Deadstart section. 

24.4.3 The System Table Track is used for Level 1 and 2 recovery. It is pointed to by byte 4 

of the DEVL entry of the MST for eq 0. It contains a copy of CMR and a complete copy of 

machine field length at CHECK POINT SYSTEM time. A partial dump is shown in Figure 24-3. 
MST snORPSS = M*00 

003371<*<*0*2fc0000205i* 
77770153000153000153 
00000000000000000000 
OOOOOOOOOOOOOOOOpjlflJL 

frgsffttp QQitgsi ooeg k?6 g 

701*30000000000030005 
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Figure 24-3. System Table Track 
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Figure 24-3. System Table Track (Continued) 
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Figure 24-3. System Table Track (Continued) 
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Figure 24-3. System Table Track (Continued) 
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25.0 INTRODUCTION 

DSD and DIS are display routines which require a dedicated PP. DSD is placed in PP1 
by STL during deadstart (see Section 24, Deadstart) and remains there for the duration. 
DIS is called to a pool PP by the operator command X DIS. When DIS is in a PP, it gets 
a control point and retains both the PP and the control point until it is ended by a DROP 
or n.DROP command. DSD and DIS (and any other PP routine, (such as snoopy, LEM, 
etc. , which desires the operator console channel) will toggle the display console by the use 
of the "* " key. User information is contained in the Installation Handbook, Instant Manual, 
and Operator's Guide. 

DSD and DIS use the common decks: COMDSYS, COMDDIS, COMDDSP, COMDTFN. Any 
routine wishing to use the console should use these common decks and the macros in DSD 
and DIS. (A complete listing of CALLDIS is obtainable within the discussion in Section 20. ) 

25. 1 DSD DISPLAY ROUTINE 

DSD runs independent of a control point,, however, when an input requires operation on a 
control point area (change memory location, n.drop, etc.), DSD will take on the attribute 
of being assigned to the control point in question until the operation is complete, usually 
by calling IDS. (See Figure 2 5-1.) 

DSD is responsible for all the system displays, accepting all system keyboard input, and 
initiating all action desired from this input. 

If a typein requires some control card action, it calls iDS to initiate this action. If a 
typein specifies a particular display, DSD will load the appropriate overlay to fill the 
screen buffers. 

As DSD receives input, it processes them one character at a time as they are received. 
Checking is performed on each character to validate the entry. DSD checks the first 
character and loads the syntax routines necessary to process any command which begins with 
this character (9AW, SAX, 9AY, 9AZ, 9AO). As the typein s continue, the entry is nar- 
rowed down to a unique entry, at which time the remainder of the entry is filled in by the 
input processor. At this point, the entry is considered complete, and the keyboard echo 
line is flashed to indicate the complete entry (This syntax facility can be toggled on and 
off by the typein 99. ) 
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Receives 

Keyboard 
Input 



Console 
Display Screens 




Drives 
Via Channel 



NOTE 

DSD does not have a PP resident and 
therefore, in order to load overlays 
it must call (via RPPM) the PP rou- 
tine 1DL, •which will get the overlay 
from the system device and send it to 
DSD via a channel. 



Call 




Transmits overlays to 
DSD over another 

channel . 

-* 



Gets Disk 
Resident Ove 
lays via a Channel 









To perform 
auxiliary functions 



Figure 25-1, DSD Overview. 



25-2 



97404700B 



seen in a system catalog. The overlays set up the buffer, and the main loop displays it 

An analyst wishing to define an overlay should get a listing of one of the DSD overlays, and 
modify a copy for his own needs. The analyst should use the macros defined in DSD for 
defining: 

1. Overlays (use OVLN macro) 

2. Overlay entry points (use ENTRY macro) 

3. Command processing (use ENTER macro) 

Listings of these macros are provided subsequently. 

DSD uses three types of overlays - SYNTAX, DISPLAY, and COMMAND. The following 
macros facilitate the organization and communication between overlays and the main 
program. 

Overlays may reside in "RPL" or "PLD". For those overlays which reside in "PLD", 
DSD calls the program (1DL) to process the physical load of the overlays, since there is 
no copy of PLL or any PP resident type load routines. 1DL will transmit the overlay to 
DSD via a channel. 

SYNTAX and COMMAND overlays are absolutely originned. Display overlays are written 
as location free routines since two must reside in DSD for the two display screens. 

1. ENTRY - Define overlay entry point. 
ENTRY NAME.D 

ENTRY NAME = Name of entry point 

(D) if present, defines display overlay entry 

Point is the current value of the origin counter. 
EXIT NAME = (address) -i- last two characters of overlay name 

2. OVLN - Generate overlay name. 
OVLN 

EXIT (N.) - last two characters of overlay name. 

3. DISPLA - Display data. (See Section 19 on K Display programming for description 

of the screen matrix. ) 
DISPLA X, Y, (TEXT) 
Entry X = X- coordinate 

Y = Y-coordinate 

TEXT = display text 
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If coordinates are not present, display text at current position. 
DISPLA MA CRO X, Y, T 

LOCAL I.J.K 

QUAL 
K MICRO 1,,$T$ 

. 1 MICCNT K 

I SET . 1+1 

I SET 1/2 

LDN K 

OAM J, CH 

QUAL * 
DIS RMT 



QUAL 




BSS 





IFNE 


X,,2 


CON 


X 


SET 


1+1 


IFNE 


Y.,2 


CON 


Y 


SET 


1+1 


DATA 


HS*Kj«S 


EQU 


I 


QUAL 


* 


RMT 




ENDM 





K 
DIS 



5. ENTER - Specify command entry 

The "ENTER" macro is used for specifying the format of the keyboard commands. 

NAME ENTER COMMAND, LOCK 

ENTER NAME = address of command processing routine as specified 
by "ENTER" macro. 

COMMAND = SYNTAX for keyboard entry. 

LOCK (if present) = SYNTAX is under lock control. 
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NOTE 
Special fields may be specified by the following characters. 

I 70 (11-8-5) alphanumeric field. 

t 71 (11-8-6) octal field. 

< 72 (12-0) used as XY - any character between *X* and 

* Y* may be used in this field. 

> 73 (11-8-7) used as XYZ - any character in the set *XYZ* 
may be used in this field. 

< 74 (8-5) terminate scan - characters in any format may follow. 

Z 75 (12-8-5) set new SYNTAX table - SYNTAX field described 
by (address) will be used for remainder of fields. 

Examples of some ENTER macro use are listed in Table 25-1. 



T^ A T"> T T7< nC .1 T\ /T „„«.-. IT 1 TVrTT7 , "D 

J. jTi.-D.Lj XI* Ct*J~ X , iVid.HU -Ui^l iiJll 



Name 


Macro 


Entry 


Name 


Macro 


Entry 


CDS 


ENTER 


* 1 


IAN 


ENTER 


(I AN t.), LOCK 


DCC 


ENTER 


(>ACDFGHJKL>,|.r 2 


AUT 


ENTER 


(MAINTENANCE.) 


DFC 


ENTER 


(>CDFG>06,'J' ,)* 3 


MCH 


ENTER 


(MCHJ.).LOCK 


ACD 


ENTER 


(ACCOUNT, +• . ) 


OAN 


ENTER 


(OAN j.), LOCK 


ACN 


ENTER 


(ACNf.),LOCK 


OFE 


ENTER 


(OFF 1. ) j 


AUT 


ENTER 


(AUTO.) 


ONE 


ENTER 


(ON|.) j 


RSA 


ENTER 


(A.) 


QUE 


ENTER 


(QUEUED ) 


IDL 
DCH 


ENTER 
ENTER 


(BLITZ.) 
(DCH\f. ), LOCK 


STM 
STP 


ENTER 
ENTER 


(STEP.), LOCK 
(STEP, |.),LOCK 


DCN 


ENTER 


(DCNf).LOCK* 4 


SYG 


ENTER 


(SYSGO.) 


SEN 


ENTER 


(EN;) 


TIM 


ENTER 


(TIME ;),LOCK 


ELD 


ENTER 


(ERRLOG.f) 


ULK 


ENTER 


(UNLOCK.) 






i 


UNS 


ENTER 


(UNSTEP.),LOCK 


FCN 
FCN 


ENTER 
ENTER 


(FCNl.).LOCK ! 
(FCNf.fJ.LOCK 

j 


IIF 
IIF 


ENTER 
ENTER 


(X.< AZ^ . )* 6 
(X< AZf, t )*7 


IDL 


TTNT'^W 


(IDLE,)* 5 i 









* 1 - means accept two legal display names such as AB, or 
CE, or AN or KB, etc. 

*2 - means accept octal field such as A, 5 or C, 5 for 
specific CP number display. 

*3 - C4, octal field or CO, CI, C2, C3, for specific 
read of CM. 

*4 - Can type in DCN only if console unlocked. 

*5 - Can type in IDLE in LOCK or UNLOCK status. 

*6 - Can type in X. anv sequence of Alohas followed bv numeric 
field. 

-7 - Same as *6 plus ", " followed by any octal field. 
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Through the discreet use of these macros and reading the DSD code, an analyst can define 
his own overlays. All the input and output processing can make the use of the features pre- 
sent in the DSD code. A flowchart of the main loop is presented in Figure 25-2. 



Inactivate 
Channel 




* 1 



DDN 
'Display Names 



DKB 
^Display Key 
Buffer 



Display 

Left 

Screen 



Display 

Right 

Screen 





Process 
Keyboard 



AVT 
'Advance Time 



CEQ 

Check 

Equipment 



CSS 
'Check Sub- 
system status 



Advance 
Cycle Count 




* 1 Ensure channel is free before attempting any action on it. 
*2 COMDSYS display system status. 

* 3 Loop. Screen must be refreshed 50 times a second 



Figure 25-2. DSD Main Loop 
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25.2 IDS 

IDS processes those functions that DSD cannot process. IDS is also called to enter jobs 
for IA J in certain cases . 

The IDS call is: 



Direct 

Cells 
IR = 



IR 



IR + 1 I IR + 2 i IR + 3 



IDS 



SC 



JC I REQ 



IR + 4 



PA RAMS 



ORDINAL 



where: 

SC = System control point 

JC = 0, control point to perform at 

REQ = Request number 

PA RAMS = Parameters 

ORDINAL = Job ordinal if JC^O. (FNT address) 

Table 25-2 is a list of all the request processors, while Table 25-3 lists the value of 
JC, REQ, PARAMS, and ORDINAL for each processor 

IDS is called by DSD to process the functions in Table 25-2. If JC is specified, IDS 
gets that control point and then processes the request. (See Figure 25-3). 



TABLE 25-2. TABLE OF REQUEST PROCESSORS _ IROP 



TRQP 


Request Number* 


* 2 
Processor Name 


Description 







DSF 


Load display buffer 




1 


MSG 


Send dayfile message 




2 


GGO 


Go 




3 


ONS 


On Switch 




4 


OFS 


Off Switch 




5 


ECB 


Enter central buffer 




6 


PGF 


Purge files 


TRQP1 


7 


RRJ 


Rerun job 




10 


ITJ 


Initiate jobs from table 




11 


IJC 


Initiate job call 




12 


JFD 


Dayfile dump 




13 


ACD 


Account file dump 




14 


ELD 


Error log dump 




15 


LOD 


Load input jobs 


> 


16 


DPQ 


Dump print queue 1 
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TABLE 25-2 (Cont'd) 



TRQP 


* 1 
Request Number 


* 2 
Processor Name 


Description j 




17 


ICJ 


Initiate control card job 




20 


MES 


Issue TELEX message 




21 


WAR 


Issue TELEX warning message 




22 


D1A 


Send TELEX user a message 




23 


CFO 


Enter data to running job 




24 


ROL 


Rollout job 




25 


SJP 


Enter job CPU priority- 




26 


SJP 


Enter job queue priority 




27 


STL 


Set job time limit 




30 


AEJ 


Assign equipment to job 




31 


DIS 


Call DIS to job 




32 


ISS 


Initiate specified subsystem 




33 


IAS 


Initiate all enabled subsystems 




34 


BIO 


Process BATCHIO operator 
commands 




35 


EUF 


Enter MAGNET UDT field 




36 


TPS 


Toggle PF status 


TRQPL 


37 




End -of- table 



* 1 Entry = 1 word indexed by request number 

* 2 Processor name - Address of request processor 

I Functions that require interlock cleared (i.e., UNLOCK status are) 1, 5, 11, 17,20, 
21,22,23,0. 

25.3 DIS 

DIS is always associated with a control point, while DSD is seldom so associated. 
(See Figure 25-3). 

When the operator types in X. DIS, DSD will call IDS which will get a control point and 
call DIS to this control point. A control point can also request DIS via a control card call. 

DIS will check that the user is validated for DIS if the system is in DEBUG status. If DIS 
is a direct call, no validation is necessary. 

DIS controls the displays in much the same manner as DSD. In addition, control point 
information exchange packages, breakpoint, 026, and control card calls can all be initated 
via DIS. 



25-8 



97404700B 



Table 25-3. IDS Processor Values 



Name 


REQ 


JC* 


PA RAMS = IR + 3 


— _____ _____________________ 

ORDINAL = IR + 4 


DSF 







/0 Back space file 


FNT address 


MSG 


1 




FWA message 




GGO 


2 








ONS 


3 




Switch Number 




OFS 


4 




Switch Number 




ECB 


5 




Address of message buffer 




PGF 


6 




File type if PURGE ALL 


FNT address if 1 requested 


RRJ 


7 




Rerun priority 




ITJ 


10 




Table number 




LTC 


11 




Address of job name 


Field length 


DFD 


12 




Equipment number 




ACD 


13 




Equipment number 




ELD 


14 




Equipment number 




LOD 


15 j ! Equipment number 


ID on FNT 


DPQ 


16 Equipment number 


ID on FNT 


ICJ 


17 | j Address of job name 


Field length 


MES 


20 j \ Address of message 




WAR 


21 




Address of message 




DIA 


22 




Address of message 


Terminal number 


CFO 


23 




FWA of message 




ROL 


24 




Rollout time, if not timed 




SJP 


25 




Priority 




SJP 


26 




Priority 




STL 


27 




New time limit 




AEJ 


30 




Equipment 




DIS 


31 






ISS 


32 




Desired control point 


Queue priority 


IAS 


33 








BIO 

EUF 


34 
35 




Parameters 
Address of entry 


BATCHIO flag and buffer 
pointer number 


TPS 


36 




Bit to toggle 

. — , 1 


Equipment number 

■ ■ - ■■■ 



JC may or may not be set depending on the circumstances of the call. 
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In general, DIS provides a convenient means to alter the running of a job, or (if called to 
a blank control point), initiate the operation of utility programs. 

All displays are displayed from a buffer by the main loop. The buffers are filled and 
modified by an overlay routine as in DSD. An analyst wishing to add or modify a display 
should follow the same procedure as in DSD. 

DIS is a transient routine that may reside in any PP and will remain for the duration of the 
job 

The DIS call is: 



IR = 



DIS 


D 


CP 





Display 
Console 

Equipment 



where: 

D = 1, direct call to control point. 

Figure 25-4 is a flowchart of the main loop. A list of the DIS overlays is given in a system 
catalog. 



Console Display 
Screens 



X.DIS 



Receives 
Keyboard 
Input 





Obtains CP if 
necessary, then J 
calls DIS into 
this PP 



Figure 25-3. DIS Overview. 
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/ 

/ T3~a 




PRS 



Preset 
Routine 



. *1 



L 



SYS 



\ Display Sys- 
tem Status 



DDN 



Display 
Display 

Names 



/ DT-S \ 

Display N 

v Left J 

\ Screen / 



Set CP 

CP = IR + 1 



Select Right 
Screen 64 
Characters 
per line 



© 



© 



Display 

Ricrht 

e 

Screen 



T 



J , 

DPS \ 



Display PP 
Status 



DKB \ 



Display Key-\ 
board Buffer/ 



/ KBI \ 

Get Keyboarc 
Input 




/' PSS \ 



Pause for 

System 



r 



CJS 




Check Job 
Status 



Cms j LOOP 




Advance 
Cvcle Count 



6 



* 1 presets storage, determines if this is a legal call. 

* 2 left screen 

* 3 if type in DROP, or error flag set with no reprieve, and no 

activity, then call 1AJ to a different PP and jump to DPP. 

Figure 25-4. DIS - Main Loop 
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SCOPE AND KRCNCS PRODUCT SETS 26 

26.0 INTRODUCTION 

klAHW^l -»_*rik-« fa* „ J- W VL £* jl* V .a. kU HtVlJ b WA WAV »-» *w V^ 1 J. J— I «_f » *X Ul WUM^b Sw. fcO « 

6RM - SCOPE record manager 

STS - Status processor 

EMG - SDA/SIS message generator 

RPV - Reprieve central program 

PFE - Extend/Alter function 

ACE - Advance control card 

PRM - Permission checking function 

CKP - Checkpoint restart 

REQ - Request equipment assignment 

DMP - Dump field length 

FORTRAN - FTN and RUN. 

COBOL 

SORT 

6RM is extensively described in the 6RM-Record Manager Reference Manual Several 
examples of 6RM used by FORTRAN. COBOL, and SORT are shown in Figure 26-1. One 
very important fact: All of the libraries SYSIO, FORTRAN, COBOL, SORT, etc. must be 
at the same PSR level. They are very interdependent and catastrophic results will occur 
if libraries are at different levels. 

26. 1 6RM 

User sets up a FIT 

6RM is a group of object time routines which use the FIT and generate a call 
to CIO. 



6RM accepts: 




File 


ORG 


SQ 


Sequential 


IS 


Indexed sequential 


DA 


Direct Access 


WA 


Word Addressable 
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f *o ooi6 cobol v<.opj»e ts/o<j/ot. 11.27.21.. pace 

00001 IDENTIFICATION DIVISION. 

00002 PROGF»f-in. SAHPLF. 

COflfJ dUTHCP. DOT. r-«rtrtl /crJ 

COOt* ENVIRONMENT DIVISION. V_0«UL./ PIM 

00005 CONFIGURATION SECTION. ' 

C00IJ6 SOURCE-CCH»UTER. 6600. 

C0OC7 OBJErT-rCMfOTER. 6600. f I T .4 ( 

OOOCH TNPUT-CL'TPUT SECTION. I !»*- JLMTV «-K«1 W» <fc_ 

0CCt« FRE-CCMROL. LI 

00-MO SELECT TEST1 ASSIGN TO TEST. 

C0011 DATA 1IV1SION. 

C0012 FILE SECTION. 

00013 FO TES*1 

0001* LABEL RECORDS APE OHITTED 

00015 0«T« RECORD IS RECOUT 

00016 FILE CONTAINS ABOUT 100 RECORDS *" _ »* Al » VT«J6- 
00*17 PLCrx CONTAINS 6*0 CHARACTERS ————— C- BC««. I-**"** 
0001« ccrren CONTAINS «"" "»■■"""' ** * ftA*VfaS 
oo?i? 01 PTCCUT PIC XC100). ^ 

00020 HORKTNG-STORAGE SECTION. 

P0021 77 TOUNTER PIC 91101 VAIUE IS 1. 

0002? 01 REC-IMAGE. 

00023 0? KR PIC XC15I VALUE IS * 6RH CHECK #. 

ooo?* c» ctNAHrc pic xtio>. 

0002«: C2 FILLER PIC XUOI VALUE IS SPACES. 

0002* 0» TLR °IC XC20I VALUE IS * FILE INTERCHANGE *. 

00027 02 FILLER PIC X)*5> VALUE IS SPACES. 



SAfPlf AO 0016 

00020 PROCEOUFE DIVISION. 

000?<? START, 

00039 CPEK OUTPUT TEST1. 

00031 AGAIN. 

0003? POVE COUNTER TO OYNAHIC. 

tllH 33 MOVE RFC-IfAGE TO RECOUT. 

0003% WRITE RECOUT. 

000 35 AOC 1 TO COUNTER. 

00016 if COUNTER GREATER THAN 100 GO TO MALT. 

00037 go TC AGAIN. 

00038 HALT. 

<° 0003? CLCSE TEST1. 

S 080*0 STOP RUN. 

O SAMPLE LENGTH IS 000077 

<t- 05JC00P SCH USEO 

-4 

O 

O 

^ Figure 26-1 6RM Examples 



CO 

-1 

*> 
o 

-l 

o 
o 

> 



POOC-filH 



SAMP 



COC 66G0 FTN V<i.0*P3i.B 0PT=1 73/09/07. 11.27.27,. 



PAGE 



10 

20 
100 



10 



EROtRAH 5AMP ITEST,TAPFWEST,OUTPUT> 

OIMENSIOK <»UFFERI10I 

CO 100 J=t,100 

PFAO 11,101 <BUFFER(I>, I ■ 1,10) 

FORMAT 11PA10) 

PRIHT 20, BUFFER 

FORMAT 111- ,10A10) 

CONTIMJE 

STOP 

ENO 



fPM ("HECK 

6RM Cl-ECK 

6PM Cl-ECK 

6RM CHECK 

6"»H CHECK 

6PH CHECK 

6PM Cl-ECK 



0000000091) 
0000000096 
0000000096 
0000000097 
000000009* 
0000000099 
OOOOOOOIOO 



FILE IMTERCHAMCE 

FILE INTERCHANGE 

FILE INTERCHANGE 

FILE INTERCHANGE 

FILE INTERCHANGE 

FILE INTERCHANGE 

FILE INTERCHANGE 



6QH 


""i-ECK 


0000000X01 


FILF 


INTERCHANGE 


SP- 


CHECK 


0000000002 


FILE 


INTERCHANGE 


ERM 


CH^C* 


0000100003 


FILE 


INTERCHANGE 


(.OH 


CHECK 


OOOCOOOOCt 


FILE 


INTERCHANGE 


6»M 


CH^CK 


0000000*05 


FILE 


INTERCHANGE 


6PH 


ri-rCK 


O0000O0C06 


FILE 


INTERCHANGE 


ERM 


CHECK 


0000000007 


FILE 


INTFRCHANGE 


6PM 


CHFPK 


OOOOOOQOOA 


FILE 


INTERCHANGE 


EBM 


CH^CK 


O00C00P0O9 


FILF 


INTERCHANGE 


ERM 


Ct- cr K 


0000000010 


FILE 


INTERCHANGE 


£DW 


C*- C CK 


0000000011 


FILE 


INTERCHANGE 


6RM 


CHECK 


0000000012 


FILE 


INTERCHANGE 


*PM 


CHECK 


0000000013 


FILE 


INTERCHANGE 


60M 


CHECK 


oooQoaoci'. 


FILE 


INTERCHANGE 


fp" 


CHECK 


0000000015 


FILE 


INTERCHANGE 


6RM 


CHECK 


0000000016 


FILE 


INTERCHANGE 


6PM 


CHECK 


0000000017 


FILE 


INTERCHANGE 


6PM 


CHTK 


0000000018 


FILE 


INTERCHANGE 


6RM 


CHECK 


0000000014 


FILE 


INTERCHANGE 



JOBOACQ. 73/09/07. eAtt HAN UNIVERSITY. 



11.27.23.JCB,C»55000. 

11.27.23.ACCOUM«YP» 

11.27.23.CO«CL<P*LG01> 

11.27.2<i.C0MFIlING SAMPLE 

11.27.26. 000 E AND 

11.27.26. 0630006 SCH USED 

11.27.26. .251 CP SECONOS COMPILATION TIME 

11. 27. 26. END CCPOL 

ll.27.J6.LGOi. 

ll.27.27.FILE(TEST,BT»C,RT»F,FL»100) 

11.27.27.REMIH0fTE$T) 

11. 27. 27. FTN. 

11.27.20. .052 CP SECnNOS COMPILATION TIME 

11.27.28.LOSFI(FILES»TEST) 

11.27.28.LGOCTESTI 

11.27.29. STOP 

11.27.29. CP 1.308 SEC. 

11. 27. 29. CM 0.006 KHH. 

11. 27. 29. MS 0.*87 KPR. 

11. 27. Mi. LP 0.233 KLK. 



to 



Figure 26-1. 6RM Examples (Continued) 



I\3 

CD 



C_«.£M\£ FA«- Tft^- 



CHK 



50 



100 



Fc GC»»« CMK tTIPEU 

OIHCNJION IH«GE I100> 

CC 100 I'10il00 t 5 

DO 50 JM»I 

l*»GE(JI » t 

MCITC 11) (IMAGE(K),K«1,I> 

CONTIKUE 

E*0 



HT=Vi 



&iM*r«v Wr%Tt. 



LLTH lOdOOOOOClJ 

OOCO0OOOC0C0OO0O0O12 
0OC0000000C000C00O1? 
0000000000000000001? 
OOCOOOOOC00000000012 
OOCOOOOOOOCODOOOOOIZ 

ooooooooooooooooooi? 

O0CO000OC0CPOD00O01? 

oocooooocoooooooooi? 
oooooooorooocooooot; 

COO 0000 000 00000 012 



LLTH 



18 



fcYnfcfl. V«snAW CH,. jdurrj* -fr.^ TAft&l 



PROGR"" SET (TAPEliOUTPUTl 

EXTERN*). EOI 

COHHC* /l»»<fL/ll'»GE(100» f FIT135l »IFND 

CULL FIL'SO IFIT.SLLFN.SLTAPEl) 

COLL CEK* (F1T,5LINPUT> 

1FNT = 
OUM * 

IF (1FKC .N c . 01 STOP 

OU*r. E T tFlT,lf*GE,OUH,OUM,OU«,lTH,EOn 

LTH * TFeTCH (FIT.2LPL) 

LLTH = L^MO 

FRINT It, H.TM,IIH»GEIUtI"l|UTHI 

FORMAT ItH ,//,»LLTH *»,O10,/ <5X,020» ) 

GO TO 5 

EKD 
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ooteoooo 
oocooooo 
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oocooooo 

00000000 
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~] 
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COH10N /LIBFL/ IH»GE«100J»FIT(35»tIENO 

TEND = 1 

CALL CtCSEM <FIT> 

RETURN 

EM) 



11.16, 
11.16 
11.16, 
11.16, 
11.16 
11.16 
11.16 
11.16 
11.16 
11.16 
11.16 
11.16 
11.17 



l>3. 

M. 
*•<■. 

*6. 

•ib. 
,46. 

«i8 

.to. 

,*« 



JOB? 
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FILE 
FTN. 

LCSE 
LGO 

CP 
GP 
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UM«YP) 

T»PE11 

«T»PEl,RT«M,BT«C t fRL«1000) 

.133 CP SECONDS COMPILATION TIME 
miLES'TAPFl) 



STOP 



1.167 SEC. 

O.OOit KNH. 
0.313 KPR. 
1.137 KLN. 
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0017 
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Figure. 26-1. 6RM Examples (Continued) 
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PROGRAM R1NP0* UNPUT l T«PEl'INPUTiT»PE3|00T« , UT» 
DIMENSION INIEVIUI, IM«GE«8> 
M * 1 

CM.L OPENHS » 3. INDEX, 11.0) 
00 100 N - 1»10 

RF8D CI, 10) JIHUGEHIt t * 1,81 
10 FO?"*T ltlO,7M0» 
1REC * IMAGE « it 
C»Lt MRITMS «3|W»6^t8tIRECt 
100 CONTINUE 
E+JO 
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fl.s 
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PROr.PM <>et (T««E3»TNPUT,0iJTP'lT> 
DIMENSION INOEXCUI ,I«AGEf H) 
CALL OPFN«SI S.INIFX.U.O) 
5 REAO 10,1 
10 FOR1AT 1110) 

IF (I .EO. .OR. I .GT. 101 GO 'o 100 

call re»ons (3 ( i"»G* r ( a,ii 

PR.TNT ?0, UHAGEIJt, J*l,»> 
20 FORMAT (110,7*101 
GO TO 5 
100 STOP 
END 
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THIS IS RECORD NUMBER FI»6 
THIS IS RECO B NUHPER ONE 
THIS IS RECORD NON« c R StVEN 
THIS IS RECORO NUNR*R TMO 
THIS IS RECORD NUHP"R TEH 
THIS tS RECORO NUMBER EIGHT 



Figure 26-1. 6RM Examples (Continued) 



o 

-1 

o 

o 



1 <* 
t R 
ABOVE 



I M 
1 H 
LINE 
1 W 



(.- coin 
■•- tDOJ 

nc- 



03Q0 UJU] 3000 0J01 
000 OP j 3 0000 1)000 



CiJ/ 



raoo oooi sooo oooo 0233 

0000 OODJ U000 0000 0000 
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Figure 26-1. 6RM Examples (Continued) 
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fir i w o- oonn oooo ojoj ooio 0:115 

Fl(? i w *- 5506 1126 0555 5555 5T55 

— ENO OF D£rn 7«l -• 



CD 
-J 
4^ 

O 

-J 

o 
o 
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FIR ? « 0- 

F 1 R a « •*- 

— FNO O c Ptr.fj^rj .. 

FIR 3 H 0- 

F 1 R J M li. 

— ENi OF "FCO 1 " 1 -- 

FIR * W 0- 

F 1 P U V *- 

— END OF RECOR1 -- 

FIR 5 M 0- 

F 1 R 5 « «•- 

~ FNO OF PFCORn — 

FIR 6 v 0- 

FIR 5 W *" 

— ENO OF PECOR 1 ! " 



00PQ 0000 0000 0000 0J02 
552* 2717 5555 5555 5555 



0003 0000 0000 0000 0007 
5523 0526 U516 5555 5555 



00G0 0000 0J0J 0000 01J6 
5523 1130 5555 5555 5555 



0000 0000 0000 0000 0012 
552li 0516 5555 5555 5555 



0000 0000 O0C0 0000 0001 
MIT 1609 5555 5559 5955 



FIR 7 V 0- 0000 01)00 0000 0000 0003 

FIR 7 w *- 552i» 1022 0505 5555 5555 
-- ENO O c =*EOORO -- 

F 1 9 10 w 0- 0000 0000 0000 0000 0010 

F 1 R 13 u It- 5505 1107 1(12* 5555 5555 

— EH" OF PFi^R'? — 

F 1 R 11 M 0- 0000 0000 S000 0000 GfrO* 

F 1 R 11 V *- 55"6 172* ?255 5555 555? 
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F 1 R 12 W 

F 1 R 12 W 
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F 1 R 13 M ir- 0000 OOOu 0000 0000 0011 

F 1 R 13 M 10- 0000 0000 0000 0O00 0010 
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-- EHO OF INFORMATION — 

~> ENO O* W»H«» — 
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Figure 26-1. 6RM Examples (Ccn Untied) 
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1C.1-. ."NO SORT Rli N 3C 

10.1 •.» r wi»iOini*i(ii 
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Figure 26-1. BUM Examples (Continued) 
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proc.(mm-id, SiSSda 
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CONf I6UKATION SECTIOr. 
SOURCE-COMPUTER. fi*00, 
diJECT-COMPUTER. 6*00. 
ImPUT-OUTpUT section, 
FilE-CONTrOL. 

SELECT FILEl ASS IGN TO T APE4- 

ORGANI7ATION JS INDEXED S 

FILE-TI^IT_JS 500 
r^SYMHOTlC KFY TTTm^KETi j 
DATA DIVISION. 

FILE SECTION. 
Fq FILE! L*BEL RECOROS ARE OMITTED 

DaTa RECORD IS REC. 
01 REC SI7E IS 100 CHARACTERS. 

o2 image. 

«3 I"l SIZE IS 6. 

<*3 THE-KEY PIC 9(4) . 

03 FILLER SIZE IS 10. 

03 IM2 SIZE IS Bo. 

working-storage section. 

77 act-kfy pic 9(«1. 

t7 mo-pecs pic 9(*1 value is 500. 



COHOL 



V«o2U« 



0f>/"l/72 »o).l*.«0. 



PAGE 



IS 0001f.3 



p^nCEDu?E divisIOm. 

CREATE. 

DISPLAY ySTART CREATING FILE*. 

OPEN OUTPUT FILE!. 

MOVE SPACES TO IMAGE. 

MOVE fl'ECOWD* TO IM1. 

MOVE **,RM FILE TEST* TO IM2. 

MOVE TO ACT-KEY. 

PERFORM WR-REc No-RECS TIMES. 

CLOSE FILEl. 

DISPLAY ifFINlSHED CREATING FILE*. 

STOP RUN. 
WR-PEC. 

AOD 1 TO act-key; 

MOVE ACT-KFY TO T"E-KFY,. 

IF ACT-KEY EQ 1 DISPLAY REC« 

IF ACT-KEY EQ NO-RECS DISPLAY REC. 

WRITE REC INVALID KEY DISPLAY *THr KEY ■ i THE-KEY STOP RUN. 



C_aGAT£ -SI* FtL£ 



.00/01/7? SCOPE 3.* SuSN]f?LEVEL CS 0V27/72 
Ot. I7.47. ,IOR002f 

1>1. l7«*7..KH.T2i0«CM*>fl000. 0^ 
ct. |7'.47.FILE( TAPE l^NL»2»'KL«630,XH|.s 1000) 
«AW7"«51. 1.791 RT SECONDS LOAD TIME 
01. 17. 5S. COBOL. 

Oi..l7-59. 2.710 RT SEcONOS LOAO TIME , 
Of. 19' 02. COMPILING SISSOA 

G/.IS.13. 000 E AND T/U DIAGNOSTICS ISStlEO 
01. 12-13. FIELD LENGTH NEfOED FOR COBOL 052700 
C/.IS.13. .f.*5. CP SECONDS COMPILATION TIME 

at ./3.13.FN0 COMOL 
0/./S.13.LGO. 

W .11.2*. 10.109 RT SECONDS LOAO TIME 
«1. fS'** .CATALOG! TAPE 1 »SI<;. 1D=DT.F0«IS) 
«/./8. AS. INITIAL CATALOG 

o/«f8.A7.PF cycle no. * ooi 
of. /£.5i.pp ■ 010 days 

o/.f£.5?.cP *.Mfc SEr. 
0/.A3.52.PP 2*. 539 SEC. 
Ot. /S. 52. 10 1.407 SEC. 
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START CREATING FILE 

RECoftooooi 6rm file test 

r.eco«ooSoo 6rm file test 

finished creating file 



Figure 26-1. 6RM Examples (Continued) 
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FIELD LENf.Ti ■-EmEO FOR C0H0L 05?70o 



Ii)twTIFIC«TION DIVISION. 
i'\iCjC,(>A»~lr\. SISSIM 
ENVIRONMENT DIVISION, 
CONf IGURAMON SECTION. 
SouRCF-COmPUTFR. 6*00. 
OMjrCT-COMPIITFR. A400. 

Input-output section. 
File-control. 

seiect file1 assign _k>~'. „.. „ 
owg.*.r-'i?ation isj^ qexed s equential 

FILF-LTMIT IS liM — _~ " " 

ACCi_SA-MQDE IV ^^EjOUENTjiD 
(^fYMR0LICKO> ISTHE-K£V7 

« tV^Mui^iun. 
file section, 
fn file1 label records are omitted 

data rfcord is hec. 

01 PEC PlC XII00) , 
".OHMNG-STORAGE SECTION. 
77 ACT-KFY PIC S»<4) VALUE IS 0. 
77 NO-RECS PIC «(*) VALUE IS 1000. 
77 TMF-KFY PIC "*«*) . 



PROCEDURE DIVISION. 
STAHTJ-l. 

(gPfj£>INPUT FILEI, 
DTSPLAY ^ACCESS FILE SEQUENTIALLY* 
An Ainu— -. 

CEliit^Ufl Al END OISPLAY jiTME ENn' 
OISPLaY REC- 
GO TO AGAIN. 
0000*3 



OSE, FILEI STOP RUN. 



0fc/fl 
t'1.23. 



a, 
oi, 



[S3 



6'1 - Zl . 
01.28. 
6(1.28. 

£t.2i. 
Gl.Ztf. 

ol.l?. 



1/7? SrO.f 3.4 SwSM02LFVEl CS 04/27/72 

14. joaon2 c 

l4..iOH.T2)n.C"mnoon. 

1 S, ATTACH (TAPri, SI S,In=DTiFO=T<;) 

If-.PF CvClE NO. b Ool 

I'-.COOOl. 

1''. 2.119 ~T SErOMDS LOAD TIME 

21 .CO-'PILTV. slSSDA 

31. 010 E A.ND T/U DIAGNOSTICS ISSUED 

3l, FIELD LENGTH NEfDFD FOR COBOL 052700 

3 >» -AM CP SECONDS COMPILATION TIME 

31.FNO CO'tOL 

31.LGO. 

*3. 11. Oo RT SECONDS LOAD TIME 

15. CP 4.5*9 SEC. 

15. PP 14.74J SEC. 

15.10 1.35? SEc. 
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RECoHDOnOA 


60M 


FlLf 


TEST 


RECORO0007 


flBM 


FILE 


TfST 


RECnRUimlrt 


frOM 


FILf 


IfST 


RECdHDp.-int) 


f,OM 


FUF 


TFST 


RECORDO'lr. 
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FlLF 


IFST 
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FILE 


Test 


RECOHOOltU 
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FILE 


TfST 


RECoRDOnl* 


ARM 


FlLF 


IfST 


REClRUOnl* 
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FlLF 


TEST 
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FILE 


1'ST 
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RECOH00019 


h»M 


FILE 


I-ST 


RECOR0002(1 


f-OM 


FlLF 


TFST 


RECORO0021 


f.fcM 


ftLe 


•EST 


RECOR0002? 


6PM 


FILE 


TEST 



l!.£C)R.O0 4 99 
R.eCjUfiD0500 
THe END 



6<>m ftlf test 
apm file test 



Figure 26-1. 6RM Examples (Continued) 
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IrENTIFICATION DIVISION. 

PROORAM-In. 5ISS0A 

ENVIRONMENT DIVISION, 

COMFIGUPAT10N SECTION, 

SOHHcE-COmPIJTeR. 6*00. 

OPJECT-COMPIJTER. 6400, 

Input-iVJTpuT SECTION. 

FlLE-COMTwoi . 

SELECT FILEl ASSIG N Tn TAPFi 

ORGANIZATION IS £MD?XeS SEQUENT I Af") 

FILE-LIMIT IS IpjL_- -~ ■ S 

ACCESS MODE IS <B«NDOHZ> 

„ T <2^rTrK£x>is the -key. 

OsTA DIVISION. 

file sfctiom. 

f d filel lapel "ecorns are omitted 
data record is rec. 

°1 REC PlC X(IOO) . 

working-Storage section, 

77 ACT-KFV PIC 9(A) VALUE IS n. 
77 NO-REcS PIC 9(«l VALUE IS 1000. 
77 THE-Kfv pic 9(*). 



sSlA ftA-^OiVA M-ttli 



SISSOA 



ono?3 

"Or?» 
•0"?c 

~ r Co?.-. 

r-O0?7 
" * f a 
0fln?r5 
oOo3o 
»f|n3| 
"3? 
"l'-33 
oo i-lt. 
ooo3s 
"003^ 
00O37 
rpr>3A 
LENGTH IS 



PROCEDURE nIVISION. 
STA&T+T-^ 

CjlPFOMPUT FILEl. 

DISPLAY *REAO EVERY 100TH RFCORD* 
AGAlM. 

ADO lno TO ACt-KFY. 

MOVE ACT-KEY TO THE-KEY. 

IF tCl^EY GREATER THAN NO-RFCS firt 

C^FA^FTLn^INvALlD KEY DISPLAY <Thf 

STOP B!J\. 

DISPLAY REC. 
GO TO ASAtN. 

RESUME-*-—^ 

Cci,OSE*"> II Fl 
DISPLAY #F 



TO RESUME, 

BAD KEY ■ * ACT-KEY 



00(11 f6 



STOP RUN. 



INISHED* 
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REAe EvFRy IOoTm RErOPO 

pJECofcDOlOn 

R£<x>^po?0o 

KFCoWlOo 

&£"Cx>M)0*0fl 

REcoftDoSOo 

THf tAO KEY - OAOO 



ftPM FILE TEST 
fcRM FILE TFST 
6RM FtLf TFST 
6RM FILE TEST 
6RM FILE TEST 



oo/n 

01 .20. 

OX. to, 
OL.zo. 
oi.Zt). 

61. ZO. 

ML. 2*. 

£>1 . 2o . 

61.20. 

Oi.Zo. 

01. to. 

61. to. 

ol.ro. 
ot. to. 
ol 4 zo. 
ot. to. 

Ot.tO. 



S"SN10?LEVE L cs */?7/7? 



1/7? SrO°F 3.* 
OS. jo»OoEf 

o^.jo«tTa->o.CM6ooon 

?n*nJ T ^^' TAPF, ' S, ' ; ' , '>" !r) T.FO= TS) 
1".RF CyCi.e Nn. > ool 

•"•coiol. 

IT. *.943 RT SECONDS LOAD Tlkr 
?\. COMPILING SISSOA 

£ raj sk.™ «v»v;:rsf\i!?.i° 

33.LGO. 

^%d ,1 * 3S< ' RT SF <"°"DS LOAD TIME 
■5*.CP 3.B30 SEc. 
5A.PP 10.709 SFr. 
5 *.I0 l.?47 SEc. 



Figure 26-1. 6RM Examples (Continued) 
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IDENTIFICATION DIVISION. 
PROGRAM-In. SISSUA 
ENVIRONMENT OtVlSlON. 

Configuration section, 
source-computer. 6*00. 
object-computer. a*oo. 
Input-output section, 
file-control, 
select file! assign, to tape1 

organization ishno exed seq uentiai 

file-limit is 

ACCESS HOQE. I CRanDOH. 

t^Borfc ke? ir*Tfir=KEv, 
data dT~ 
File section, 
fo f1lei label «ec0rds are omitteo 

data record is rec 
0] rec ptc x(ioo). 
working-storage section, 

77 ACT-Kfy PIC 9<4> VALUE IS 0. 
77 NO-RE^S PIC 9(4) VALUE IS 1000. 
01 AAAAA 

OS FILLER PIC X(6| VALUE IS fprCORo*. 

02 the-kfv pic 9<*). 

02 filler pic x ( ioi value is spacfs. 

oa dum pic X( B 0) value is prewritten record*. 



sSii HpM-TlT 



SISSOA 



-.■>n?7 
»0^2« 
' n r 5t 
-.■)."> 3 t 
<"i-3l 

00133 
■<0134 
rO^K 
?0<-3is 
'0^37 
-0133 
10039 
"0040 

Bijn*i 

O00»2 
LENGTH 



IS 



Cay ^REWRITE EVERY looTH RECnRD*. 



HELD LENGTH nEfdFD FOR COBOL 052700 



PROCEDURE DIVISION. 
STAJiUJ. 

V£Pmit-0 FILE1. 

nTspTTA 

AGAIN. 

ADD Ino TO ACT-KEY. 
MOVE ACT-KEY TO THE-KEY. 

IF_&CT-KEY GREATER THAN NO-RECS Go TO RESUME. 
fiJLWJtQl? REC FROM AAAAA INVALID KEY 

DISPLAY ,.THE SAO KEY «# Acf-KEY STOP RUN. 
DISPLAY PEC. 
GO TO AGAIN. 
KESUMJL^^^ 

QkOSpFILEl. 
DISPLAY ^FINISHED* 
STOP RUN. 

noons 



REWRITE EVERY JOOTH RFCORD 



en 



RECO>*DO)Do 
RECOR0O2OO 
RECOR00300 
RECORU0400 
RECORO0S00 
THE 8A0 KEY 



RFWRITlEN RECORD 
rfwritTen RECORD 
REWRITTEN RECOHn 
REWRITTEN RECORD 
rfwritTEn RECO fl n 



■ 06no 



SVSN102LEVEL CS 04/27/72 



Ois/oi/7? scope 3.* 

01. 53. 3n.. 100002m 
01.S3.3o. ['O«.T2nn.e«6n000„ 

01.S3.31.ATTArH(TAPFl,SIS,IO*DTtF0»IS) 

01.43. 34. PF CYCLE NO. ■ Oiil 

01.53.3».COrlOL. 

01.13.4o. 6.1H7 PT SECONDS LOAD TIME 

01. 53. 45. CO-PILING SISSOA 

0t.S4.0S. 001 fc AND T/U DIAGNOSTICS ISSUED 

0U44.0S. FIELO LENGTH NEFOED FOR COROL 052700 

01. 54. 09. .703 CP SEcOMDS COMPILATION TIME 

01. 54. 09. FN/) COHOL 

01.54.09.LGP, 

01.54. 29. 19.234 RT SEcOnOS loao t , he 

01.54. 41. CP 4.190 SEC. 

01. 54. 41. pp 23.726 SEc» 

0UB4.4UIO 1.391 SEC. 



Figure 26-1. 6RM Examples (Continued) 



block 
type 



RT = Record type 

BT= C binary old 6000 type 

E) MT's Xrecs/block 
I old FORTRAN type 

See examples in Figure 26-1. 



26.2 PROCESSOR OVERLAYS 

The other processors mentioned previously (namely, STS, EMG, RPV, PFE, ACE, PRM, 
CKP, REQ, and DMP) are all overlays in the PP routine SFP except CKP, REQ and DMP. 
See Section 4, PP Resident, for a SFP description. See Section 5 for a discussion of 
DMP, and Section 22 for a discussion of CKP. The other routines are described subsequently. 



26.2.1 Status Processor - STS 

18 6 

RA+1 = 



12 



STS FUNCTION CODE ADR 





12 12 


23 


1 





LL | LR 





A 



Function 01 - Return mass storage devices status Returns status of mass storage devices 
starting at address+1 of address contained in bits 0-17 of program call. Return is defined 
by address: 



ADR 



where : 

LL = Number of words, excluding this header word, to be used for return information; 
must be set by user to other than 0. 

LR = Number of status words returned. 

A = Auto recall reply: set to by user and set to 1 when request is complete 

The mass storage device status is returned, 1 word per device, in the following format: 



ADR+N = 



3 


9 


12 


12 


6 


6 


12 





STATUS 


DEV TYPE 


EST ORD 


CHAN 


EQ 


PRUS 



where: 

STATUS = 000 - Not available, off, not in use 
040 - Unloaded pack 
120 - KRONOS system routines 
140 - KRONOS system routines on pack 
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620 - Contains permanent files 

640 - Pack with permanent files 

700 - KRONOS system and permanent files 

740 - KRONOS system and perm files on pack 



I PT>1 Q TT f+f\Ac 



AA - 6603 Disk System 

AB - 6638 Disk System 

AD - 865 Drum System 

AF - 814 Disk System 

AL - 821 Disk System 

AM - 841 Disk System 

AP - 854 Disk System 

AY - 844 Disk System 



PRUs = Number of PRUs/100 octal of space remaining on the device, 
indicates at least 262, 100 PRUs available. 



A value of 7777 



Function 02 - Return file status. 

Returns to the calling program the FNT/FST entries of files requested whose names are 

set in every third location starting with PARM+1 of address contained in the "PARM" 

field of the calling program. If the file exists, the file name will be replaced by the 

FNT/FST of KRONOS mapped into the SCOPE 3.4 FNT/FST. If the file does not exist, 

the file name will be zeroed out. 

Format of location pointed to by "PARM": 



PARM = 



12 



12 



12 



23 






LL 


LR i 


A 



where: 
LL 

LR 
A 



Number of words, excluding this header word, to be used for return 
information: must be set by user to a multiple of three 

Length of status area returned. 

Auto recall reply: set to zero by user and set to one when request is 
complete. 
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Format of mapped 3 word KRONOS FNT/FST. 









42 






1 


5 




12 




file name 





CP 





Devt 





1st track 


curtrack 





cur sec 





disp. code Pern 





CS 



24 



12 



12 



Function 3 -Return PRU count of file(s) 

Returns to the calling program the number of PRUs of the files requested whose names are 
set in every second word starting at "PARM+1" of address contained in the "PARM" field 
of the calling program. If the file exists, the PRU count will be returned in bits 0-23 
of the second word. If the file does not exist, the second word will be zero. 

Format of location pointed to by "PARM". 



12 



12 



12 



23 



T PARM = 






LL 


LR 





A 



where: 

LL 

LR 
A 



= Number of words, excluding this header, to be used: must be set by 
user to a multiple of 2 . 

= Length of status reply area. 

= Auto recall reply: set to zero by user and set to one when request is 
complete. 



26.2.2 SDA/SIS Message Generator - EMG 

Returns messages to SDA/SIS as requested by a message code contained in the PP call 
parameter area. EMG performs the function of the SCOPE 3.4 PP program "MSD". 

ENTRY (IR - IR+4 = call to "MSD" with the format: 



IR 



MSD 



CP/AO 



Message code 



Return address 



where: 

MESSAGE CODE 



Message ordinal of message to be returned 



RETURN ADDRESS = CM address to return message beginning at (return address 

+ 1). 

EXIT (Return Address) t 0. Upon completion of message transfer, (return 

address) is set to: 
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Mess Code Message 



Liicbo ai^c 



TT 



where: 

MESS CODE = Message code issued in "MSD" call. 

MESS SIZE = Message size in CM words of message returned 



25.2.3 Extract Error Text-(Used By COBOL) D00 

D00 is a routine that will extract messages from specially created system text decks to 
aid in analyzing error situations resulting from a product set. By using an error number 
and the proper system text deck, an error diagnostic will be transmitted to the dayfile 
and/or to a specified CM buffer. All system text decks to be used must be MS resident. 



IR 



Address = 



where: 
A 

A 
A 

IR = 



where: 

STA TUS 





18 




6 




16 






18 


D00 


CP 
NO 





ADDRESS 


12 12 


12 18 


6 


A 


MSG NO 


BUF SIZE 


BUF ADDRESS 





42 




18 


TEXT DECK NAME 


INSERT CHARACT 
i 



= 4000B - If insertions to messages. 
= 2000B - If dayfile message transfer. 
= 1000B - If CM buffer message transfer. 



36 



12 



12 



ADDRESS 


STATUS 


1 



= If transmittal to dayfile only. 

= 7777B if error. 

= CM words written if CM buffer transmittal. 



26.2.4 Reprieve CP Program - RPV 

RPV provides the ability for a CPU routine to get control back after a specified normal or 
abnormal termination condition. There are two cases in which RPV may be called, one 
is to initialize, the other is to reset. 
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The program recovery capability of SCOPE 3.4 is under KEONOS 2. 1 to provide support of 
the SCOPE 3.4 products under KRONOS 2. 1 through the use of the RECOVR macro contained 
in the SCOPE ACTCOM carried under KRONOS 2.1. 

26. 2. 4. 1 RECOVR Function 

The RECOVR macro allows a user program to gain control at the time that normal or ab- 
normal job termination procedures would otherwise occur. Initialization of RECOVR at 
the beginning of a program establishes the conditions under which control is to be regained 
and specifies the address of user recovery code. If the stated condition occurs during pro- 
gram execution, control returns to the user code. RECOVR macro expansion calls the 
SETUP, subroutine. 

RECOVR is concerned with conditions that affect job execution. The conditions under which 
KRONOS will return control to the user, and the octal values that will select them in the 
call to RECOVR, are: 

Arithmetic mode error 001 

PP call error 002 

Time limit 004 

Operator drop 010 

System abort 020 

CP abort 040 

Normal termination 100 

Conditions can be combined as desired, with octal values up to 177 allowed in the flag field 
of the call to RECOVR. 

At least five seconds of central processor time always will be available for user code ex- 
ecution. RECOVR makes the exchange jump package and RA + 1 contents available to the 
program if user recovery code is executed, and gives the user the option of having normal 
or abnormal job termination output. 

Initialization of RECOVR within code at the beginning of a program results in an entry in a 
stack of requests for PP program RPV. Only one set of recovery conditions can exist within 
RPV, but RECOVR allows up to five user and system sets of flags and code for each pro- 
gram. The last RECOVR initialization will receive control first. 

A checksum of the user recovery code can be requested during initialization. If flagged 
conditions subsequently occur, RECOVR will again checksum the code before returning 
control to it. This gives some assurance of user code integrity before it is executed. 
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RECOVR is initialized from a COMPASS program with: 

RECOVR name, flags, checksum 

name Address of code to be executed if flagged conditions occur; 

a return jump will be made to this location 

flags Octal value for conditions under which recovery code is to be 

executed, as outlined above; default is 77 

checksum Last word address of recovery code to be checksummed; if 
no checksum 

If one of the flagged conditions occurs, the address of the exchange jump package will be in 
register Bl and the RA address in B3. Register Al will contain the address of the list of 
the parameters passed in B1-B3. Register B2 will contain a B; if the recovery code sets 
B2 to a non-zero value, or if the code contains an ENDRUN macro or an RA + 1 request for 
END, normal job termination procedures will follow. Otherwise, abnormal job termination 
procedures will follow recovery code execution. 

If a program calling RECOVR contains overlays, both the call to RECOVR and the user 
recovery code should be a part of the level 0, code. 

The exchange jump package returned by RECOVR is in the format returned by DMP, with 
the system error code that caused recovery code execution in bits 0-17 of the first word. 
If the P register shows zero in the package because a mode error occurred, bits 31-47 
of RA + will contain the P register value. System error codes that may be returned are: 

Normal termination 

Requested time limit exceeded 1 

Arithmetic mode error 2 

PPU abort 3 

CPU abort 4 

PP call error 5 

Operator dropped job 6 

Program stop 7 

File limit 10 

Track limit 11 

Mag tape limit 12 

System abort 13 

Both the FORTRAN and FORTRAN Extended languages contain RECOVR subroutines as 
detailed in their respective manuals. 
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RPV 








OPT 





ADDRESS 



26.2.4.2 RPV Function 

RPV is the PPU portion of the RECOVR CP/PP package and is contained as a function in 
the PP program SFP. RPV should never be called directly, but utilize the CP portion for 
all program recovery work. 

18 6 4 7 6 18 

RA+1 = T ~ 

where: 

R = If set indicates a reset requested. Reset -will be performed from the address 
last set. 

OPT = Options when reprieve will be invoked. Each bit represents an error condition. 

1 - Mode error 20 - System abort 

2 - RA + 1 error 40 - CPU abort 

4 - Time or storage limit exceeded 1 00 - Normal termination 

10 —Operator drop 

EXIT = If initialization option byte will be set in each, and exit address field will 
contain called address with bit 17 set. 



26.2.4.3 RECOVR Error Messages 

RECOVER - TOO MANY RECOVERY REQUESTS.- More than 5 recovery initializations 
occurred without a recovery being processed. 

RECOVR - BAD CHECKSUM. - The post-recovery checksum of users recovery routine 
does not equal the pre-recovery checksum. 

RECOVR - BAD ARGUMENT LIST. - Illegal parameters in pre-recovery initialization call. 

26.2.4 RPV Error Messages 

SFP /RPV INITIALIZATION ERROR. - If entry to RPV initialization without the Error Exit 
Return Address set. 

REPRIEVE ABORTED BAD CHECKSUM. - Post-recovery checksum of RECOVR routine 
does not match pre-recovery checksum. 

REPRIEVE ABORTED-VALIDATION TL. - Current time limit +5 seconds exceeds time 
that user has been validated for. 

JOB REPRIEVED. * - The job has been successfully reprieved. 

REPRIEVE ABORTED SYSTEM ERROR. - Error condition unknown to RPV. 

REPRIEVE ROUTINE NOT IN FL. - The RECOVR CP routine not in users field length. 
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SFP/RPV CANNOT RESTORE PREVIOUS ERROR. - RPV cannot restore the error that 
caused the initial termination. 

(PREVIOUS ERROR CONDITION RESET. ) - RPV has restored the error condition that 
caused the termination. 

26.2. 5 Extend/Alter File Function - PFE 

Alters the requested file to have an EOI recorded at the current position of the mass storage 
file. 

18 6 18 18 

RA+1 = 

where: 

P = Set for Auto -Recall 
Word contained at the address in the function call is: 

42 9 

PARM = ~™ ~ " 

where : 

RET = If the "RC" and "RT" parameter defined in "0", a return code will be 
. available to the user. The following codes will be returned: 

000 - Function successful 

003 - Unknown LFN 

025 - File unavailable 

= Options available are the following: 

Bit 6 - Return code to user in RET 

F = Function code for alter. Bits 2 - 5 = 0111. 

C = Completion bit. Set when function is complete. 



LOGICAL FILE NAME 


RET j F 


O 


C 



The PFE error message is: SFP/PFE ILLEGAL ALTER FUNCTION. 
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2 6.2.6 Advance Control Card - ACE 

Reads/backspaces next/previous control card into RA-70B - RA-77B with, the option to 
place the control card in the dayfile and/or to crack and store the control card parameters 
in SCOPE 3.4/KRONOS 2. 1 format into RA-2 - RA+53B. If a read function is issued and 
the pointer is at the end of the control card record, and EOR status (bit 4 set in the function 
code) and RA-70B - RA-77B cleared. If a backspace function is issued and the pointer is 
at the beginning of the control card record, the pointer is not changed and an EOR status 
is returned. When function is complete, the completion bit (bit 0) is set and returned to 
the user. 



RA + 1 



24 


9 


3 


6 


18 


ACEP 


O 


F 


O 


FUNC ADDRESS 



where: 
F 



X01 - Crack parameters in KRONOS 2. 1 format 
X10 - Crack parameters in SCOPE 3.4 format 
1XX - Issue control card to dayfile 



FUNC ADDRESS = CM word containing function to be performed. 



FUNC = 



_48_ 



12 



FUNCTION 



where: 

FUNC 
FUNC 



= 0010 - Read next control card and advance control card pointer. 
= 0040 - Backspace to previous control card. 



EXIT Completion bit set in FUNCTION. The following error message can be displayed: 
SFP/ACE FUNCTION CODE UNDEFINED - The function at the FUNC ADDRESS is undefined. 

26.2 7 SCOPE 3.4 Permission Checking Function - PRM 

PRM will scan for an FNT entry whose address is contained in the call and, if found, will 
map the KRONOS 2. 1 file permission bits into the SCOPE 3.4 permission bits and return to 
the user as a status. If the call address is out of range or the requested file does not 
exist, no diagnostic will be issued and no status will be returned to the user. 



24 



18 



18 



PRM 


PARM ADDRESS 



RA+1 



wh e re : 

PARM ADDRESS = CM address which contains the file name to search for 



26-22 



97404700B 



FARM 



42 



LFN 


CODE | O 


C i 



where: 

CODE 



= A 5-bit code returned by PRM in bits 9-13. The rightmost 4 bits are 
the permission bits. The octal codes are: 

01 - Read 

02 - Extend 
04 - Modify 
10 - Control 

The leftmost bit of the 5-bit field is the permanent file bit. If 1, 
the file is a direct access or indirect access with control PF . If 
the 5-bit field is 17, the LFN is either an indirect file without control 
or a non-permanent file type. 

= Completion bit. Set to 1 when function is completed. 



Note 
Due to the different concepts between the KRONOS 2 1 and 
SCOPE 3.4 permanent file structures, the following restric- 
tions are in effect. 

Any permanent file whose write lockout and/or execute bit(s) 
are set in the FNT, a permanent file with read only per- 
mission will be returned to the user. 

26.2.8 DMP/REQ/CKP 

SFP consists of routines which set up a special processing word in the calling control point 
area (SPCW) for follow-up processing by 1AJ and a CP program associated with the call. 



Format of SPCW: 



SPCW 





6 


18 


18 


ENTRY POINT 


CODES 


PARAMETER 


PARAMETER 
ADDRESS 



where: 

ENTRY POINT = Name of entry in CP program. 

CODES = Control codes for use by 1A J 1 /A, 1/B, 1/C, 1/D, 2/0 



97404700B 



26-23 



A = Request active (1AJ use only) 

B = Clear RA-1 before reload if not set 

C = Remainder of word is parameter list not address of parameter list 

D = Do not restart CPU (LA J use only) 

PARAMETER = Input /output parameter 

18/ parameter on input 

12/ status, 6/ unused on output 

PARM ADDR = Parameter address passed in call. 

Each SFP routine will set the rollout flag in the control point area. The following dayfile 
message occurs: 

SFP - SPECIAL REQUEST PROCESSING ERR. = the SPCW word was busy. 

The three calls are: 

CKP - Checkpoint request 

REQ - Request equipment assignment 

DMP - Dump field length 

The KRONOS product sets are: 

BASIC 

APL 

TSRUN 

TEXT EDITOR 

CYBERLINK 

TRANEX 

TELEX 

All product sets are described in their respective Reference Manuals. The product sets 
are run as normal jobs with the exception of CYBERLINK, TRANEX, and TELEX which 
are subsystems. See Section 13 for a description of TELEX and Section 14 for a description 
of TRANEX. 
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start procedures. Some examples of these two types of dumps are given on the following 
pages. For a description of dead start dump selection consult the KRONOS 2, 1 Operator's 
Guide, section 2. 

Subsequent pages provide a partial listing of the CMR and PP 0, 1, 2, and 5 dumps. 
(Values from Figures 2-2 and 2-3.) 

CPUMTR FWA 15050 
LWA 16765 

TPMN, TPPR FWA 16766 

PPI EP 17142 from PXPP in CMR (63) 

PPR - 1007 = 16057 
PMN - 717 = 15767 
MTR - 20 = 15070 

BATCHIO at CP 26B, CPA at 5400B 

PP Communication area - 6200 

BATCHIO CPA at 5400 CP number 26 
1st CPA at 200 CP number 1 
EST at 6600 

Notice that PP5 is lTDand PP2 is ITS. 

MXD, SCX, SCX1, IXP start at 17042 from Figure 3-7. 
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013230 1501 0716 "521, 31,57 C-330 5511. 1,157 3333 5733 3757 5555 5555 3442 5741 3434 5520 0522 0305 1624 55^3 

013231, 2025 5525 2411 lull 3201 2'tll 1716 570': OOCO COCO 5531, 4157 3333 5733 3757 5527 0111 2455 31,15 2455 

01321,0 0317 1520 14C5 2435 570"! Cus-C 0000 OOOG CCOO 0000 553<» U157 3333 5733 3757 5515 0107 16:5 21,55 24"5 

013244 2215 1116 I1 124 r 55C 1617 5524 P12C 0555 1217 P223 5700 OiHO P331 3PGP OOCv 553", 4157 3333 5733 3757 

^ 01325C 0320 5555 5555 5555 5533 5740 3643 5523 05^3 5701 0000 OODO 03J3 0000 OOOi OCOC 0000 300C OOCO 0011 

-a 013?5<» 0000 30"n "DC" fCCC r n r : C3CC OOOC OOOC 000!) 0003 0003 OOflO 0-11'J OOUO OOPC 000" OODO OOOC 0000 0010 

^ oooc 0300 ooor ccot 0003 oo, ■■(. 0030 oooc oooo ccor oooi 00:3 on jo ;ooc occ oooc oooc ooci ooro o?td 

O 013320 5531, 1,157 3333 5733 3757 55 17 2005 2201 21,17 2255 0<>22 1720 57J0 COOO OOOl OOOO 0000 000( OOCO 01"0 

013324 ooor ott rccp noor. 0101 or 1 ? cooc 030c ooco ?oc? 0000 toco 0333 cooo ooor 0001 uooo ooc-t. 0000 ao"o 

0000 oono 0000 0000 0000 oono 0000 0000 ooco 0000 0000 0000 0000 0000 oooc 0001 0000 oooc ooco occ 

01342C 5531, M57 331,2 5735 3657 23?U 1115 2511, 0157 0003 5531. 1.157 3343 5734 1.257 2321, 1115 2511, 0124 1117 

013<,2i, 1655 1116 1121. 1101 21,05 C457 0000 000" OOCO COOO 0003 30CC 0300 OOOC OOOI 0030 0000 OOOt OOCO 00*0 

0131,30 OOOC OOCC UOOO OCOC 000" CfOO OOOO OOOC OOCO OCOO 0003 0000 0000 0000 OOOC 0000 0000 OOOC OOCO 0000 

"OOP OOTC TOO COOC OOOO OO'JO 0000 OOOC OOCO GOOG 0000 3000 00J3 COCO 0000 000" 0000 OOOC OOCO OOf" 1 

013520 5531, 1,157 31.33 5733 1.357 lilCl C101 3333 3515 5755 1523 1722 21,56 3333 33«.C 5633 3335 3357 OOCO OPOO 

013521, 5531, 1,157 31,33 5733 1.1,57 Cl'Jl C131 3335 3324 5755 5311, OH 3 5617 5621, 3523 21,32 5656 3457 OOCO OOno 

01353C 5531, 1,157 31.33 5733 1.1,57 C1J1 T131 3333 *» 2 <» 5755 531<» 01,03 5617 5621, 0523 21,0? 5656 31,57 OOCO 30O0 

013531, 5531, 1.157 31.33 5731. 3357 Oil 0101 3333 3515 5755 1523 1722 21,56 3333 3536 5633 3331, 1,057 OOCO Ipnp 

01354C 5531, 1,157 3433 5734 31,57 0101 0131 3331. 1,021. 5755 5311, ,)(,;3 5^7 562 t, 523 21,32 5656 31,57 OOOO 0310 

01351,1, 5531, 1,157 31,33 5731. 3557 Cl'l 0131 3335 3621, 5755 5311, G 1,0 3 5617 5621, 0523 21.02 5656 31,57 OOCO OOOC 

013550 5531, 1,157 31,33 5731, 3657 0101 0101 3333 3515 5755 1523 1722 21,56 3333 31,35 5633 3333 1,157 OOCO OCOO 

013551, 5531, l»157 31,33 5731, 3757 CI 1 0131 3333 1,121, 5755 5311, 34 3 5617 5624 0523 21,02 5656 31,57 OOOO OCOO 

013560 5534 1,157 31, 33 5731. 1,357 C101 0131 3331, 3521, 5755 5311. 3 1,? 3 5617 5621, 0523 21.12 5656 31,57 OOCO 3f0 

013561, 5531, 4157 31,33 5731, 1,157 OKI 0101 3333 3515 5755 1523 1722 21,56 3333 3337 5633 3335 3556 3333 31,1,2 

013570 5700 OOOO OOOO OOOO OOOO 5531, 1,157 3433 5731. 1,257 0101 0131 3331. 4224 3755 5311. OUC 3 5617 5621, 3523 

013571, 21,02 5656 '457 CCC OOOO 5531. 1,157 31,33 5731, 1,357 101 0131 3335 3521. 5755 5311. 01.03 5617 5621. 05?3 

01360C 21.02 5656 31.57 COOO OOOO 5531. (,157 31,33 5731, (,357 0131 (/131 3333 3721. 5755 5311. C4L3 5617 5621, 0523 

013601, ?(,0 2 5656 31,57 OOOO OOOO 5531, 1,157 31,33 5735 31,57 dot l,j 1 3333 3515 5755 1523 1722 21,56 3333 31,36 

013610 5633 3333 1,256 3333 31.31. 57^C OOOO OOOC OCtO OOOO 5531. 1.157 31.33 5735 3557 Old 0131 3331. 31.21. 5755 

013611, 53H, L n,n3 5617 5624 0523 24:2 5656 31,57 OOCO CCOO 5531, 1,157 31,33 5735 3557 31H 0131 3331, 31.21, 5755 

013620 21,05 2321, C255 5555 ",61,6 3333 1.133 3333 OOOO COOO 5531. 1.157 31,33 5735 3557 0101 0131 3333 4224 5755 

013621, 5311, rn,r>3 5^17 5 6 2i, 052 ^ 2 ,,-j 5656 3 ,, 57 00c , 0flon 553(( ,, 157 3 ,, 33 5735 3557 01Q1 pl31 333(( J%z[> 5/1 , 5 

013630 5311, 01,33 5617 5621, 0523 21. 2 5656 31.57 OOCO COOO 5531. 1.157 31.33 5735 «»i»57 101 0101 3333 3515 5755 

013631. 1523 1722 21,56 3333 3531, 57 <G OOOO 3000 POOJ COOO 5531, 1,157 31,33 5 7 36 3357 oiOl 0131 3335 31,21, 5755 

01361.0 5311, C433 5617 5624 0523 24L-2 5656 31.57 OOCO OOOO 5531, 1,157 31,33 5736 3357 C101 0131 3335 31,21, 5755 

• 01361,1, 21,05 2321, 0255 5555 1,61,6 3333 1,133 3333 COCO OOOO 5531, 1.157 31,33 5737 1,357 HOI 0101 3333 3515 5755 

013650 1523 1722 21.56 3333 31,1,1 571 G OOOO 030C OOOO CCOO 5531, 1.157 31,33 5737 1,1,57 0101 0131 3331, 1,121, 5755 

013651, 5311, 01,03 5617 5621, 0523 ?4"2 5656 31,57 00C3 COOO 5531, 1,157 31,33 571.0 1.257 0131 0101 3333 3515 5755 

01366C 1523 1722 21,56 3333 31.31. 57CC 0030 OOOO OOCO OOOO 5531. 1,157 31,33 571,0 1,357 0101 0131 3331. 31,21, 5755 

013661, 5311, (ii,; 3 56I7 5 6 2i, 0523 24"2 5656 31,57 OOCO OOOO 5531, 1,157 31,31, 5733 '4157 0101 tlOl 3333 3515 5755 

013670 1523 1722 21,56 3333 31,33 57C0 OOOO OOOC OOCO COOO 5531, 1,157 31,31, 5733 1,257 C101 0131 3331, 3321. 5755 

013671, 5311, C4C3 5617 5621, 0523 24C2 5656 31,57 C Of 3 CCOO 5531. 1,157 31,31, 5733 1,257 0101 0101 3333 3515 5755 

013700 1523 1722 21,56 3333 353U 5730 OOOC 3000 OOCO 0303 5531, 1,157 31,31. 5733 1,1.57 0101 C131 3335 31,21. 5755 

013701. 5311. 01.33 5617 5621, 0523 21, 2 5656 31,57 PCfC OCOC 5531, 1,157 31,31, 5731, 31,57 0101 0101 3333 3515 5755 

013710 1523 1722 21.56 3333 31,37 57CC OOOO OOOO OOOO 0003 5531, 1,157 31,31, 5731, 3557 0101 (,131 3331, 3721, 5755 

013711. 53H, 01,03 5617 5621, C523 242 5656 31,57 OOCO OOOO 5531, 1,157 31,31, 5735 3357 C101 C101 3333 3515 5755 

013720 1523 1722 21.56 3333 3536 5633 3335 3556 3333 31,1,3 57C0 CCCO OOJO COCO OOOC 5531, 1,157 31,31, 5735 31,57 

013721, C101 C131 3331, l,C2l, 5755 5311, 01,0 3 5617 5624 C523 24'!2 5656 31,57 COOO OOOO 2321. 1115 01C2 11C2 5755 

013730 0103 0317 2516 21,56 0217 C223 1115 3556 57C0 OCOO 5531, 1,157 331.C 571,0 3657 2321, 1115 01C2 11C2 5755 

013731, 5511 IMI, "5P7 1 1 «• 5501 C'^3 1725 1621, 5006 0115 1111, 3157 0330 OOOO OOOU 5531, 1,157 331,1 5731, 3757 

01371,0 21,11, 2M3 0102 1402 5755 2414 2056 0315 1,133 3333 3356 21,1,2 1,21,2 1,257 OOCt 5531, 1,157 3341 5734 3757 

013741, 2411, 2333 C1C2 14 r 2 5755 GK3 0317 2516 2456 1514 1756 57tC ? : COOC OOCC 5534 4157 3341 5734 3757 

313750 2414 2333 C1C2 1402 5755 C317 152C 0123 2357 0003 5534 4157 3341 5734 4257 2414 2033 0102 14C2 5755 

013754 5501 2323 0515 C214 3155 0317 1520 1405 24C 5 5755 5555 3737 33 33 3302 5523 0315 5525 23f. 5 n 457 OCCC, 

01376C 5534 4157 3341 5734 4257 21,11, 2033 3102 14C2 5755 5555 5555 3457 4342 3455 550 3 2025 5523 U5C3 1716 

to 013764 3423 5555 r>123 2335 15Q? 1431 5524 1115 C557 CCOO 5534 4157 3342 5734 4357 2415 1405 3055 5523 5755 

-J 013770 2405 141-5 3C57 OCOO 3000 5534 4157 3342 5735 3657 2324 1115 2514 ?123 5755 • 2324 1115 2514 0157 OOOO 

O 013774 5534 4157 3343 5734 4257 2324 1115 2514 C123 5755 2324 1115 2514 124 1117 1655 1116 1124 llfl 24"5 

*> 014000 0457 OQCr CCOC "C3C C300 5534 4157 3344 5736 3557 0101 Ol.-l 3333 3515 5755 1523 1722 2456 3333 3437 

^ 014004 570C OCCC r COP CCOC CSOO 5534 4157 3344 5736 3757 OlOl OHl 3333 3515 5755 1523 1722 2456 3333 3441 

p 014310 570P OPCC O^OO PrCG COOO 5534 4157 3344 5737 3457 C101 3101 3333 3515 5755 1523 1722 2456 3333 3533 

•*" 314014 570P 01LC "OCC COOC OOCO 5534 4157 3344 5737 3657 ' C1C1 3 1" 1 3333 3515 5755 1523 1722 2456 3333 3433 

01402C 5633 33'4 4057 CCCO 0300 55*4 4157 3344 5737 4C57 Cl?l Ol^l 3333 3515 5755 1523 1722 2456 3333 3536 

014024 5633 33 T 5 3557 Cr?C OOOC 5534 4157 3344 57*7 4'57 0101 1C1 3333 3515 5755 1523 1722 2456 3333 3341 



rD 014030 "5633 3333- 1*057 CDOQ OilQO 5534 4157 334'. 5737 4457 01IU OKI 3333 3515 5755 1523 1722 2456 3333 3435 '° 

-i 014034 5833 3333 3755 3333 344* 57' r. 0030 tlOf OCC'i CfCG 553". 4157 3 3 <»«» 5740 3557 0411 2333 0103 2223 5755 

*; Q1404C 0411 2357 ?r.OP COOL" 00 C 5534 4157 3344 574J 3557 C411 2333 01(13 2223 5755 1517 0405 5133 5200 OCOO 

4- 014044 5534 4157 3344 ^741 3557 C411 2333 1)103 2223 5755 2205 2425 2216 5111 1621) 2524 5200 OOOC OOCO 0000 

q' 014050 5534 4157 3344 574" 3557 C411 2333 0103 2223 5755 0411 2357 01 Of OCUC OCDO 5534 4157 3344 5740 3657 

o 114054 nici 01P1 **33 *515 5755 1523 1722 2456 3333 3436 5633 3334 3456 3333 3 342 5701 0000 OOOT OJfO QC30 

> 014060 5534 4157 3344 5740 4257 CI 1 0101 3333 3515 5755 1523 1722 2456 3333 3437 570" 0003 OOOt OOPD OC Oil 

014064 5534 4157 3344 574P 4357 till 0131 3334 3724 5755 5314 U4C3 5617 5624 0523 2402 5656 3457 OOCO Of): 

014070 5534 4157 3433 5733 3557 C 1 . 1 0101 3333 3515 5755 1523 1722 2456 3333 3534 570" OOCO OOOt OOCO OCOO- 

1114074 5534 4157 3433 5733 3757 01,1 3101 3333 3515 5755 1523 1722 2456 3333 3441 570P 000" 000 0010 OC10 

014100 5534 4157 343'' 5733 4057 Cl,l 3131 3334 4124 5755 5314 "■ 4 . 3 5617 5624 0523 2432 5656 3457 OOCO OCOf 

P14104 5534 4157 3433 5733 4057 Cl.l C131 3334 4124 5755 2405 2324 0?55 5555 4646 3333 4133 3333 OOfO 0CP3 

014110 5534 4157 343-« 5733 4C57 CI 1 0101 3333 3515 5756 1523 1722 2456 3333 3433 57G" 0000 OOOC OOCO OCOC 

014114 5534 4157 3433 5733 4157 Cl"l 0131 3334 3324 5755 5314 4:3 5617 5624 3523 24J2 5656 3467 OOCO 00*0 

014120 D000 Onr? nnpr COGC GOO 1 5534 4157 3344 5733 4157 0133 2531 3334 3324 5755 2U06 5555 5555 555.5 5507 

014124 0524 5555 2405 2324 C257 OCf.i OCOO 0301' COCO CC03 5534 4157 3344 5734 3357 fcl33 2531 3334 3524 5755 

014130 2006 5555 5555 5555 5507 P524-5555 2405 2324 P 25 7 COOO 0000 CKO OOliO OOOC 5534 4157 3344 5734 3457 

"14134 0133 2531 3334 3424 5755 20 6 5555 5555 5555 5507 0524 5555 24">5 2324 1257 0030 0000 OOOC OOCO OOOO 

014140 5534 4157 3344 5734 3457 tl*3 2531 3335 3424 5755 2006 5555 5555 5555 5507 0524 5555 2405 2324 0257 

014144 --000 00C ^CCr. 0030 OOOO 5534 4157 3344 5734 4^57 C133 2531 3334 3624 5755 2tJ6 5555 5555 5555 55"7 

014150 "524 5555 2405 2324 C257 CO-^u 003C OOOP 0003 OOOO 2324 1115 .'1":2 07G2 5755 1523 5555 5555 5555 5533 

P14154 5733 3337 5513 2C22 5701 COL} G03C OOOC COCO OOOO 5534 4157 3340 574P 3357 2324 1115 0102 1023 5755 

014160 0322 5555 5555 5555 5533 6733 3737 5513 03C4 5755 OOOO GOPQ OTC'J OOOO O'JOC 5534 4157 334C 5740 3457 

014164 2324 1115 01C2 1CQ2 5755 2CC6 5555 5555 5555 2301 2635 5555 24 5 2324 3257 OOOO OOOO OOOC OOCO OOOO 

014170 5534 4157 *34C 674C 3457 2324 1115 0102 10' 2 5755 P.32P 5555 5555 5555 5533 5733 3342 5523 t)5r 3 57PC 

014174 06DP OPPO COCO CCOO COOfi 5534 4157 334P 5740 3457 2324 1115 012 10D2 5755 1523 5555 5555 5555 5533 

014200 5733 3337 5513 2C 22 5700 CCC* POOG OOOt OOCO OOOC 5534 4157 3346 6740 3557 2324 1115 ulC2 0712 5755 

014204 1420 5555 5555 5555 5533 5733 3734 5513 1416 5755 OOOO OOOO 03 JO 100C 000? 5534 4157 334C 5740 3657 

014210 2324 1115 1C 2 1123 5755 C322 5555 5555 5555 5533 5733 3736 5513 03C4 5755 OUOr 0003 OOCt OOCO 00"0 

014214 5534 4157 3340 574C 3657 2324 1115 0102 11C2 5755 0321 5555 5555 5555 5533 5733 3334 5523 C5f3 570") 

014220 OOOO OOP" 33P0 POOP OOOO 5534 4157 334C 574d 3757 2324 1115 01~2 10U2 5755 142P 5555 5555 5555 5533 

014224 5733 3734 5513 1416 5755 COCC OOOC 030C 00C3 OOOO 5534 4157 3343 574C 4257 2324 1115 0102 11C2 5755 

014230 142C 5555 5555 5555 5533 5733 3643 5513 1416 5755 0300 OOCO 00"0 COliP OOOO 5534 4157 3341 5734 3757 

014234 2414 2133 01C2 1423 5755 C 322 5555 5555 5555 5533 5736 3444 5513 r 3l4 5755 OOOC OOOO OOOC OOOO 003" 

014240 5534 4157 3341 5734 4*57 2414 2033 3102 14f 2 5755 C 320 5555 5555 5555 5534 5743 4235 5523 05C3 5713 

014244 OOOP OOCC OCOP CCCC POO) 5534 4157 3341 5734 4257 2414 2033 01 ,Z 14ii 2 5755 0315 5555 5555 5555 5533 

014250 5733 3435 551* 2710 5700 C )( C OOOO 300P OOOO 0»03 5534 4157 3341 5734 4257 2414 2033 0102 14C2 5755 

014254 1523 5555 5555 5555 5533 6733 4234 5513 2022 57P3 0003 "OOC OC ?3 tOl'C ODCS 5534 4157 3341 5740 3457 

014260 2414 21)33 11P2 1432 5755 14*0 5555 5555 5555 5533 5737 4243 5613 1416 5755 OOOO 0030 OOOf C0f:O 0001 

314264 5534 4157 3342 5734 4457 24' 5 1405 3055 5523 5755 2006 5555 5555 124 2401 03ir 5555 2311 15C6 1114 

014270 P556 2331 2324 r515 t?57 CO..0 OOOC OOOP POOP P"OC 5534 4157 3342 5734 4457 24'j5 1405 3055 5523 5755 

014274 2006 5565 5555 C124 2401 C31f. 5555 1605 2427 1722 1355 2371 2324 C515 3C57 0t3f COCO OOOT OCi C 0030 

014300 5534 4167 3343 6733 3757 2324 1115 2514 0123 5755 2006 5555 5555 5555 5507 0524 5555 2324 1115 0614 

314304 5755 PIC? "CC" r-rnQ OPOO 6534 4157 3343 5733 3757 2324 1115 2514 C123 5755 2CI36 5555 5555 5555 55"7 

014310 0524 5555 2324 1115 0614 5755 OOOO OOOC OCCn 000" 5534 4157 3343 5736 4157 0101 0131 3333 3724 5755 

T14314 2523 0522 6555 f?17 P223 1115 3455 5514 17L7 0715 0455 1116 57 '; 3 OOv!; 330i 5534 4157 3343 57.36 4357 

014320 P1C1 0131 3334 4224 5756 2523 0522 5555 C217 (22 3 1115 3455 5514 17..7 CI7C5 C455 1116 570f OOCO 0C1C 

014324 5534 4157 3343 5737 3457 Cl.l 1)131 3334 3724 5755 2523 3522 5555 0217 3223 1115 3455 5514 17C7 07*5 

01433C "455 1116 570T CCo: COOO 55*4 4157 3343 5737 3457 0101 "131 3334 4124 5 755 2523 C522 5555 u217 3223 

P14334 1115 3465 6514 17C7 P705 1455 1116 570P OCOO C P 3 5634 4157 3343 5737 3557 C101 P131 3333 4224 5755 

01434C 2523 «522 5555 P217 P223 1115 3455 5514 17C7 P7-.5 0455 1116 571)0 COuC OOOf 5534 4157 3343 5737 3657 

014344 3101 0131 3334 3324 5755 2523 0522 5555 0217 i 22 3 1115 3455 5514 17L7 37:5 i455 1116 570C OPIO 00 n <- 

31435C 5534 4167 334^ 5737 3657 CI 1 0131 3333 4124 5755 2523 C522 5555 "217 3223 1115 3455 5514 1717 07' 1 5 

014354 1455 1116 r .7Pf CCPP 3 0" 5534 4157 3343 5737 3657 C1P1 C131 3334 4P24 5755 2523 0522 5555 C217 02?3 

114360 1115 3465 6^14 17"7 C 7 jS ' 455 1116 570C 0P(.:. PPOD 5534 4157 3343 5737 3757 U101 0131 3335 3624 5755 

!^j C14364 2523 0522 5555 C217 P223 1115 3455 5514 1717 C ?■■ 5 I 455 1116 570C fflUP OCOO 5534 4157 3343 5737 3757 

i 01437P '101 0131 7J*5 ^324 5755 2523 0522 5556 0217 C22? 1115 3455 5514 17i,7 07C5 C 455 1116 57CC OOCO 3C0r. 

^ 314374 5534 41 r 7 3*43 5737 '4C57 ill 0131 3337 4 P 24 5/55 2523 ?522 5555 0217 3223 1115 3455 5514 1 7' 7 7" 5 

O1440C '455 1116 57ti: PC03 OCO" 5534 4157 3343 6737 4? r i 7 (ilOl 3131 3335 3524 5755 2523 C522 5555 0217 02'3 

^14404 1115 3455 5514 1767 P7P5 I 455 1116 570!; 3CC3 CTO; 5531, i.ic/ 331,3 5737 1,357 Oldl ,131 3334 3524 5755 

014410 2523 3522 6565 P217 0223 1115 3455 5514 17C7 076 (455 1116 57.0 COuC C f : 5534 4157 3343 5737 4457 

014414 1101 0131 *334 3424 5755 2623 0522 5555 0217 C223 1115 3465 5514 17D7 0705 0455 1116 570C OOOO OGftT 

■314420 5534 41 r 7 334* 5737 (,(,57 Cl'l 0131 3334 3624 6755 2523 ;522 5555 f217 3223 1115 3455 5514 17(7 07^5 

014424 ,45 r > 1116 c 7f' f '. " P 3 " 55^4 4157 3343 574^ 34 r -7 C131 -1*1 3335 _I 424 5755 2523 C522 5555 C217 3223 
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QUESTIONS/ANSWERS SETS 28 



28.0 INTRODUCTION 

This section consists of 15 question/answer sets. Each question set is identified by number 
together with the appropriate section in this manual to which it relates. 

The answer sets follow the last question set. 

28.1 QUESTION SETS 

Obtain a current listing of the following areas which will be used for some of the Question 
Sets. 

1 . Catalog of the system 

2. Dump of CMR. (Use program listed in Section 23.5 or that shown in Section 27.) 
3 . SYSTEXT (PPCOM, CPCOM) 
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QUESTION SET NO. 1 (CMR Section 2) 

Obtain a dump of a current system CMR (Use the program shown in Section 2 3 to obtain 
one. ) Answers are based on the dump in Section 27. 

1 For this system - 

a. How many PP's? 

b. How many control points? 

c. How much central memory? 

d. Does the CEJ/MEJ option exist? 

e. How long is CMR? 

2 Is there a PP program running in PP3?, PP9? If so, which program ? 

3. Are any of the PP's making MONITOR requests? 

4. Describe the peripheral equipment configuration for this system. 

5. Which device holds the system files? Permanent files? 

6. Locate the file SYSTEM, i.e. , which equipment and which track does the file reside on? 
Where is the file positioned? 

7. Identify File Name, File Type, Control Point assignment, equipment, and file posi- 
tions at the following FNT locations; 

6704, 6714, 6726, 6734 

8. How much CM is available? 

9. What is the job switch (CPU SLOT TIME) delay'' 

10. What is the time of day? 

11. Which control point has access to the CPU? 

12. What is the original input queue priority for a BATCH job? 

13. What CPU priority is assigned to an EI200 job? 

| 14. What is the ROLLIN queue priorities for TELEX origin jobs ? 

15. CIO is a PP program residing in the RPL. Find its RPL entry. 

16. What is the name of the program following CIO in the RPL. 

17. What are the base addresses of the PLD, RCL, and CLD? What are the names of the 
1st entry in each library or directory? 
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18. Where does the system dayfile begin? The dayfile dump buffer? 

19. Which PP has access to channel 0? Channel 3? Channel 1 OB? Channel 20B? 

20. What is the first unavailable channel? 

21. The following questions refer to control point 5: (or any active control point) 

a. What is Jobname and Origin? 

b. What is the control point status? 

c. How many PP's assigned? Which ones are they? 

d. What is its RA and FL? 

e. What are CPU and QUEUE priorities? 

f How much CPU time has been accumulated? 

g. What is the user number and user index for this .job? 

h. How many sectors of mass storage have been transferred? 

i. What is the first control card in the control card buffer? 

j. What is the next control card to be executed? 

22. Wnich PPs have been locked out (turned off) by the system and how did you arrive 
at the answer. 

23. Why can't the FNT table start or end beyond location 4096D? 
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QUESTION SET NO. 2 (MONITOR Section 3) 

1. Explain system interaction, i.e. the means of communication between POOL PROCES- 
SORS, MONITOR, and a CONTROL POINT. 

2 . What XCHG packages exist with 

a. CEJ/MEJ option 

b No CEJ/MEJ option 

3. What does a pool processor do to make a CPUMTR request 

a With CEJ/MEJ option 

b. Without CEJ/MEJ option 

4. How does the PPMTR make a CPUMTR request 

a. With CEJ/MEJ option 

b. Without CEJ/MEJ option 

5. How does a CONTROL POINT make a system request 

a. With CEJ/MEJ option 

b. Without CEJ/MEJ option 

6. How does the CPUMTR decide which control point to activate? If a new control point 
is activated, how does CPUMTR manage the exchange packages? 

7. What is the difference between CPUMTR program mode and monitor mode? 

8. When in monitor mode, what does the "XJ" do? In program mode? 

9. What section of the CPUMTR will be activated for a pool processor request? A 
PPMTR request? How is this accomplished? 

10. Explain what each of the PPMTR timed scan processors accomplish? 

11. What does the PPMTR do when it detects that a control point has exceeded its CPU 
TIME SLICE? 

12 How does PPMTR take a control point out of periodic recall? 

13. Who processes all RA+1 requests? 

I 14. What criteria does the PPMTR use when switching control points? 

15. Basically, how does the CPUMTR determine which control point should get access to 
the CPU? 

16. Devise a scheme for using two sub-control points. Tell how you would implement it. 
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QUESTION SET NO. 3 (PP RESIDENT Section 4) 

1. Where must a PP program be coded to run, if it is to interface with PPRES? 

2. Why is it desirable to have a pool processor pause for storage relocation? 

3. What is a pool processor doing when it is waiting for MONITOR to assign it to a job? 

4. How does a PP program make requests to MONITOR? How does it know if the request 
has been honored? How does PP know when request is completed? 

5. How do two PP's keep from getting the same channel? 

6. How does a pool processor program decide which control point it is attached to? 

7. How could a PP program write a message to the control point dayfile? 

8. After pausing for storage relocation, where will a PP program find the updated 
RA and FL for the control point it is attached to? 

9. Since some PP programs will not fit in a PP, individual functions may have to be 
written as overlays How can a program get one of these overlays loaded? 

10. How is a mass storage driver loaded? 

11. What 3 entry points exist in all mass storage drivers? 

12. Why should a programmer be very careful about using location 7000 - 7777 when 
dealing with mass storage I/O? 

13. Design and flowchart a PP program to list in the control point dayfile all common 
file names as found in the FNT 
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QUESTION SET NO. 4 (JOB PROCESSING Section 6) 
1SJ - Job Scheduler 

1. When is 1SJ called? 

2. How is 1SJ requested? 

3. How do the queue priorities get aged? What routine actually does the aging? 

4. How is the CM TIME SLICE checked? What happens if a control point has exceeded 
its CM TIME SLICE? 

5. Can you disable priority evaluation? Job scheduling? Auto rollout? 

6. Under what conditions might the job scheduler request that a job be rolled out? 

7. What criteria does 1SJ use to determine the "BEST" job for scheduling? 

8. When does 1SJ call 1AJ? 1RI? 

9. What does 1SJ do if MONITOR indicates that a PP doesn't exist for 1AJ or 1RI? 

1AJ - Advance Job 

10 Why does PPMTR call 1AJ? 

11. What are the 3 main overlays that 1AJ calls? 

12. Explain why the overlay 3AA, BEGIN JOB, is called and what it accomplishes. 

13. Does the BEGIN JOB overlay ever get called for a TELEX origin job? 

14. Why would the overlay 3AB, PROCESS ERROR FLAG be called? What processing 
does it do? 

15. Which 1AJ overlay is called to process the next control card? 

16. Which control cards will be processed entirely within the 1AJ PP? 

17. Where are the majority of most of the control cards processed? How does control 
get to these routines? 

18. What does 1AJ do to process a program call card which refers to a user's file 
referenced in the FNT? 

19. How does 1A J load an absolute CP program that is referenced in the CLD? 



28-6 97404700A 



20. How does 1AJ process the KRONOS control language statements? 

21. Is it legal to call a PP program from a control card? If so, how does 1AJ process it? 

22. Write a CP job that can read absolute memory. Include all control cards and use 
a DMP- special entry point. 

23. What will the dump contain if you include a DMP (field length) card immediately 
after executing the job written for 22, 

24. Explain the sequence of events when the call card for the job in 22 is encountered. 
Continue the explanation when the DMP card is encountered. 

25. What words in CMR are used to process sub system initiation? 

26. What does IDS do when a sub system is initiated? 

27. What is the OUTPUT queue? What is the ROLLOUT queue? 

28. How does a rollout file differ from a DM* file? 

29. Why isn't the ACCOUNT card aborted by the system? 
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QUESTION SET NO. 5 (SYSTEM I/O Section 7) 

1. Explain the purpose of the PP Resident routine SET MASS STORAGE (SMS). 

2. Explain the system table linkage in accomplishing I/O from a central processor 
program . 

3. Why do you specify a sector count when requesting mass storage space? 

4. What subroutine within a mass storage driver would you use to read a sector? 
Write a sector? Position a mass storage device? 

5. Why is the last operation when writing a mass storage, a DROP TRACK monitor 
function? 

6. Go through the system table linkage for any file you wish using the CMR dump you 
generated. What is this files length in sectors? (For the CMR dump included use 
file STIMFL. Where is the FNT located? Describe it, and trace table linkage. ) 
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QUESTION SET NO. 8 (CIO Section 8) 

1 , If CIO gets a request to process a non-existent file, what happens ? 

2, Does CIO need help from any other PP to do mass storage I/O? Explain what 
happens during a mass storage read /write operation. 

*3 TTrtw Hrtac PTf^l V>< >rl rlla *. G «^rt«-. T/AO 17^.^^ ...u*j- u~-.~ A -*~. .]..*,;.._ - «„_-:-.„ nJ?«n 

w. *jw>« «wC3 v-i.w iA a.ii^A^ i dituvui i/ w i iJAyAOlll Wliab iltt^J^HO UUi Ulg St i-dL£IUUIXI £\JliJri.J^f 

operation. 

4. Explain the term re -write in place. 

5. Under what conditions will CIO drop out, while accomplishing a mass storage read 
operation? 

6. Explain what happens when CIO gets a read request for a magnetic tape 

7. What happens when CIO gets a RE AD/ WRITE request directed to/ from a TTY type 
equipment? 

8. If you were to add another I/O driver to the system, what changes must you make 
to CIO? 
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QUESTION SET NO. 7 (MAGNET & RESEX Section 9) 

1. Name some of the control cards processed by RESEX? 

2. Since RESEX is a CP routine that runs at the user's control point, how does the 
system avoid destroying the user's job when loading RESEX? (Briefly) 

3. What is the purpose of the PREVIEW display? 

4. Only one routine updates information for the PREVIEW display Which routine? 

5. The FST entry for a magnetic tape file contains a UDT address. Where are UDT 
entries stored? 

6. Briefly, what is the purpose of the RESOURC control card? 
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QUESTION SET NO. 8 (FILE MANAGERS Section 10) 

PERMANENT FILE QUESTIONS 
Refer to the dump created in Question Set 1 where necessary. 

1. What is the first track of the INDIRECT file chain? The PERMIT buffers? 

2. How many tracks are allocated to INDIRECT permanent files: Where is this informa- 

3. How many tracks are allocated for PERMIT buffers and catalog tracks? 
4 Do any DIRECT access permanent files exist? 

6. How can PFM keep track of "holes" in the INDIRECT file chain? 

7 Assume user number USEROOl has permanent file XYZ. What implied permission 

will user number USER* ** be granted? 

8. What is the difference between a SEMI-PRIVATE and LIBRARY file? 

9. Must INDIRECT access permanent files reside on a user's MASTER DEVICE? 
DIRECT ACCESS? 

10 Is multi-read access possible with DIRECT access permanent files? If so, how is 
it implemented? 

11. Why is multi-read access no problem when dealing with INDIRECT files? 

12 What happens when you ATTACH a DIRECT access file and have WRITE permission? 
If one user attaches a file with WRITE permission, can another user attach this file? 
Why? 

13. What happens when you PURGE a direct access permanent file? 

14. What happens when you DEFINE an existing file that resides on a device not configured 
to hold permanent files? Could the above situation ever occur? 



QUESTION SET NO. 9 (LOADER and Binary Deck Formats Section 12) 
1 What difference exists between OVL and ABS binary deck formats? 

2. Why is ABS format desirable for utility program routines? 

3. What is the 1st table in any binary deck? 

4. Which KRONOS program processes relocatable binary decks? How is this program 
loaded? 

5. What does the KRONOS relocatable loader do when it detects: 

a. An OVL or ABS binary deck table. 

b. A loader control card. 

6. Following the label table, what must be the 1st table of a relocatable binary deck? 
What is this table used for? 

7 What control cards does the loader read and process? 

8. How are USER LIBRARIES utilized? 

9. Can a user specify his own user libraries? If so, how? 

10. What PP program is called as a result of an OVERLAY system macro? How does 
it accomplish its task? 

11. What usefullness is ASR? How would you put a PP program on an ASR? How can 
ASR be easily eliminated? 

12. Why is it important to ensure that all the SCOPE 3 .4 libraries are at the same 
PSR level? 
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QUESTION SET NO. 10 (TELEX Section 13) 

1. Which CPU and PPU programs make up the TELEX INTERACTIVE subsystem? 

2. Describe in general the TELEX control point. 

3. How is the dynamic memory associated with TELEX, i.e., POT3 managed? 

4 . Explain in general the TELEX origin job flow for each of the following: 

a. Job initiation 

b. Terminal input 

c. Terminal output 

5. What is the interface between TELEX and 1TD - the 6676 driver? 

6. How do PP programs 1TA and 1TO interface with TELEX? 

7. What is the TELEX re-entry table used for? 

8. Name and explain each of the TELEX internal queues. 

9. Where is all of the current information about any given terminal kept? 

10. What is a multi- terminal job? 

11 How do the terminals get processed as TELEX progresses around its main loop? 

12. What happens when TELEX requests a PP thru the CPUMTR and no PP's are 
available? Is this handled as a special case for TELEX? Why? 

13. How does TELEX get activated? 

14. Why does TELEX queue up a group of requests for 1TA? 

15. Why are all initial TELEX jobs scheduled to the rollin queue instead of the input queue? 

16. Why does 1TA create a dummy rollin file for each terminal at log-in time? 

17. What happens when a TELEX origin job terminates? 

18. What function does 1TO accomplish for TELEX? 

19. Explain why an output is followed bv an input in 1TD. 
20 Explain the re-entrant concept in 1TD. 
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QUESTION SET NO. 11 (EXPORT/IMPORT Section 16) 

1. Why does EI200 utilize a control point? What prevents this control point from being 
rolled out? Why does E200CP get the CPU "whenever" it wants? 

2. What tables are associated with each terminal? 

3. How does 1ED, the 6671 driver, communicate with 1LS, the EI200 executive? 

4. Who initiates EI200CP? Why? How? 

5 What characteristic of the 6671 driver, 1ED, enables the 200 U.T. user the ability 

to SUSPEND a file which is currently being printed? 

I 6. Which function does the EI200 SERVICE PROCESSOR-XPS accomplish? Who calls 
XPS? 

7. How does EI200 accomplish mass storage I/O? 

8. Trace the flow of data from a 200 U.T. card reader to the INPUT QUEUE. 

9. Trace the flow of data from the OUTPUT QUEUE to a 200 U.T. line printer. 

10 How does EI200 determine which terminal a file in the OUTPUT QUEUE should be 
routed to? 
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1. What 3 PP programs are involved in the BATCHIO subsystem? 

2. How is the BATCHIO control point utilized? 

3. Wh' D ' can't the BATCHIO control point ever be rolled out? 

4. What is happening when BATCHIO is in its "IDLE" state? 

5. How does 1CD, the BATCHIO UNIT RECORD EQ. DRIVER, do I/O to/ from mass 
storage ? 

6. What does BATCHIO do to submit a job to KRONOS? 

now does DA li^niVJ uiuize me i.u neiu m ail rol entry ' 

8. What function do the DCW words serve? 

9. How is the DRQR one word request stack utilized? How does 1CD know the request 
is for him ? 

10. How does HO know when to call its preset routine? 
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QUESTION SET NO. 13 (DEADSTART Section 24) 

1. Why are all the PPs A register set to 10000B? 

2 What are each of the PPs doing at deadstart time? 

3. Why are the position of the first 10 PP routines on the deadstart tape important? 

4. What happens to the information represented on the deadstart panel at deadstart time? 

5. What does SYSEDIT do at deadstart time? 

6. Explain the importance of PPUL1B? 

7. What does STL do before dropping out? Why is this last step necessary? 

8. What is the philosophy of recovery in KRONOS V2 1? 
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QUESTION SET NO, 14 (DSD and DIS Section 25) 

1. When does DSD take on the attribute of being attached to a Control Point? 

2 . How does DSD use IDS ? 

3. Do the overlays actually display the buffer? If not, what does? 

4. Explain the sequence of events when the console operator types X.DIS (CR) (carriage 
return) ? 

5. How do DSD and DIS both use the console display device? 
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QUESTION SET NO. 15 (INSTALL Installation Handbook) 

1. Given the common file MODS (see following example) modify PFDUMP, 1RO, and 
1TA and: 

a. Modify the running system 

b. Build a new deadstart tape 

* IDENT PFDUM7 

* DECK PFDUMP 
*I, 463 

NZ X1,GRL2.2 IF NOT MASTER DEVICE 

SA 1 ORDNO 

GRL2.2 BSS 

* / * * * * TO HALT CANCEROUS FNT GROWTH 
*DECK 1RO 

*D,KRON14.1,KRON14.2 
*I, 1098 

LDN 

STD CM+1 

* / *#** PRIMARY FILE FNT MASHED ON RECOVERY. 

* / * * * * ALSO NULL FILES NOT VALIDATED ON RECOVERY. 
*DECK 1TA 

*D, 1645, 1651 
*I, 3526 

LDD BA 

LMC BFMS+2+TTSS+VFST* 5 

ZJN VFLO IF PRIMARY FILE 

LDM 2.BA 

ZJN VFLX IF FILE NOT WRITTEN ON 

VFLO BSS 

0000000000000000000000 

2 Write a procedure file to modify and to create a new user library 

3. Write a job to add the above procedure file to a new deadstart tape. 
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QUESTION SET No. 15 (continued) 

Write out a CMRDECK for the following system configuration: 

Mass Storage Equipment 

1 . 6638 with Unit on Channel and Unit 1 on Channel 1 . Both units are to be 
configured to hold "Temporary Files". Unit is to be the "System" device 
when no "SYSTEM" entry is typed during Deadstart. 

2. Four 844's configured as two dual -access devices with Units and 1 as one | 
device and Units 2 and 3 as the other. They will ail be accessed via Channels 

2 and 3 . 

These two devices make up the default Permanent File Family named "FAMX" 
Assign Family Device Numbers 40 and 41. Both are to hold Direct Access 
Permanent Files . Define one device as the Master Device for Users where 
User Index ends in 0, 2, 4, 6, and the other for those ending in 1 , 3, 5, 7. 

3. One single 854 on Channel 5 (Controller No. 4) to be used as an "Auxiliary 
Device" . 

4. 512K of ECS with DDP available (Channel 20) for use as an "Alternate System 
Device" . 

5. Four 844's configured as two dual -access devices with units and 1 as one 
device, and units 2 and 3 as the other. They will all be accessed via channels 
2 and 3. Make them available to receive a family configured the same as FAMX. 

Unit Record Equipment 

1. One 405 Card Reader on Channel 11 (Controller No. 4) 

2. One 415 Card Punch on Channel 11 (Controller No. 5) 

3. One 512 Printer on Channel 22 (Controller No. 6) 

Display Console Equipment 

One 612 Display Console on Channel 10 (Controller No. 7) 

Magnetic Taoe Equipment 

1. Three 657 Magnetic Tape Drives, Controller No. 5, Units - 2 on Channel 12. 

2, Two 659 Magnetic Tape Drives, Controller No. 6, Units - 1 on Channel 13. 

Communications Multiplexer Equipment 

1. One 6671 Multiplexer, Controller No. 7, on Channel 24 to be used by Export/Import. 

2. One 567 6 Multiplexer, Controller No. 5, on Channel 23 with 50 lines available. 
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One 6671 Multiplexer, Controller No. 4, on Channel 24 for use by the TELEX 
time-sharing subsystem. Make 10 lines available. 

One 667 6 Multiplexer entry for use by the Time -sharing Stimulator. Use Controller 
No. 3, Channel 25, and 10 available lines. 



Dummy Equipment 

Put TE and NE entries in the CMRDECK even though they are generated automatically. 

Miscellaneous Entries 

1. Specify a name. 

2. Specify 8 Control Points. 

3. Increase the length of the File Name Table to 1300„ words. 
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28,2 ANSWER SETS 
ANSWER TO NO. 1 

1} 3/ 1QI3 13CC Question <££/ LTuJil ^w4ViJ\ WUT'LI I. 

b) 27B from CMR word 2 

c) 300000B from CMR word 1 

d) yes from CMR word 1 

6; 03uuui3 iX"Orn \^.ivii\ wuru <su 

2) PP3 no IR = ** * turned off from CMR word 62 30 
PP9 yes IR = 1AJ from CMR word 6310 

3) yes PP4 OR=12 RCHM (Reserve channel) from CMR word 6241 

PP11D OR = 22 RSYM (request system) from CMR word 6331 
PP12D OR=3 CCHM (check channel) from CMR word 6341 
PP15D OR=12 from CMR word 6371 

4) Use EST pointers in CMR word 5. 
EST FWA = 6600, LWA = 6700, 

LWA+1 of MS = 6601 means only one MS device in system 

EQO = DI, EQ10=DS, EQ12=CR, EQ13-CP (off), EQ20--LQ, EQ21 = LP, etc. Note EQ30 = 

TT (off). EQ31=TT (for stimulator), EQ40=ST (off). 

5) EQ0 for both. 

6) Use FNT pointers in CMR word 4 

FNT FWA=6700, LWA = 7700 length is 1000B words or 400B files. 

SYSTEM FNT is at CMR word 6 700. 

EQ0, track 2 (4002 indicates link to next track in chain), file is rewound since current 
track = 2 and current sector = 1. 

7) a) 6704. SALVARE, EQ0. track 236, rewound, type 7, COMMON 
b) 6714, 1IOVAAN, EQO, no track, assigned to CP26, type LOCAL=6B. 
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c) 6726, INPUT*, EQO, track 306, positioned to sector 2, type input=0, original 
assigned to CP2. This is the input file for CP2. 

d) 6734, TESTB, EQO, track 303 positioned to sector 3, type ll=primary terminal 
I assigned to CP4. Note TESTB is an indirect PF so the type is set=ll . 

8) 47100B from CMR word 23. 

19) 10 milliseconds from CMR word 24 
10) 16.11.22 from CMR word 30 

11) From word 60. IDLE package has the CPU. EXCHANGE address is 17122 which is the 
address of the IDLE exchange package. CPU assignment is 0, which means no CP has 
the CPU. 

12) Use JBC pointer from CMR word 4 
JBC FWA = 10550 

JBC order is SYSOT, BCOT, EIOT, TIOT. MTOT 

SYOT FWA = 10550 

BCOT FWA = 10560 

EIOT FWA = 10570 

TXOT FWA = 10600 

MTOT FWA = 10610 

so INPUT QUEUE priority for BATCH is 2400, from CMR word 10560 

13) CMR word 10573 CPU priority for EIOT = 30. 

| 14) CMR word 10601 ROLLIN queue priority for TXOT = 4004, 3740, and 7000. 

15) Use PP resident pointer from CMR word 1. 

PP resident FWA = 17646. CIO is at 17646 and is 312 CM words long. 

16) Next entry at 20160. PP name is 2CA. 

17) a) PLD FWA = 33246 from CMR word 2 
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RCL FWA = 33245 from CMS word 5 

Note that word 33245 = and indicates an empty library. 

>CLD FWA =33423 from CMR word 7 

b) RPL, CIO 
PLD, ADC 
RCL, empty 
CLD; SYSEDIT 

18) a) Dayfile buffer pointers FWA = 6440 from CMR word 3. 

Normal dayfile buffer begins at 13520 
Account dayfile buffer begins at 10620 
Error dayfile buffer begins at 10720 
CP1 dayfile buffer begins at 11020 
CP2 dayfile buffer begins at 11120 

b) 14620 from CMR word 3. Dayfile pointer for CP30 (N+l) = 6524 and has garbage 
so no dayfile pointer for SYSTEM CP . 

19) Channel status table begins at word 100 
Channel none from CMR word 100 
Channel 3 none from CMR word 100 

Channel 10B PP1 from CMR word 101 (PP1 is DSD and CH10 is the display channel. ) 
Channel 20BPP11 from CMR word 103 

20! Channel 17B, Bit 6 is set on. Channel 34B and 35B also are unavailable. 

21) CP5 is at address 1 01 000 000 = 1200B 

a) AAAY022 type 3 = TXOT. word 1221 

b) 555 555 555 



987 654 321 
000 000 100 



#PPs 
001 



word 1220 
W = 0, X = 0, R = 0, job advancement flag is set. 

The job is being advanced, it is typed TXOT, so it will be rolled out to TELEX. 

c) 1PP is assigned. (It is 1AJ PP9 word 6310. ) 

d) RA=232600, FL=25600, P=124. from words 1201, 1202, and 1200. 

e) CPU = 30, Queue = 7000 from 1222. 
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f) 102 milliseconds from 1250 or 1254. From 1224 bytes and 1, the time used is 
102 ms so job has not run out of time. 

g) UN=BOBSIMl, UI=3 from 1264. 
h) 2 sectors from 1252. 

i) $LDC, O, TESTB,,1. from 1330 and 1331. 
j) There are no more control cards. 



| 22) PP3, PP6, PP7, PP13D, PP16D, PP17D. Their IR = 



23) The FNT pointers in word 4 are only 12 bits in length and are exact addresses. Hence, 
7777B = 4096D is the largest address possible. 



28-24 97404700C 



ANSWER TO NO. 2 

1) CP uses RA + i calls. 

PP uses OR and IR calls. 

2) a) Each PP has one, each CP has one, two idle, and two sub CP exchange packages 
b) All of the above plus disable central exchange return package DXP, and disable 

central exchange program DXJ 

3) a) PP will issue MXN with request in OR. 

b) PP will wait with request in OR for MTR to issue an EXN. 

4) a) MTR will issue MXN with request in XO. 
b) MTR will issue EXN with request in XO. 

5) a) CP issues XJ with RA+1 request 

b) CP waits for monitor (MTR) to find its RA+1 request I 

6) a) CPUMTR activates the CP with highest CPU priority that can run in the system | 

at this time, 
b) CPUMTR will insure that the CP which is losing the CPU will have its exchange 
package in its own CPA . 

7) CPUMTR monitor mode is not interruptable. CPUMTR program mode is interruptable 
(program mode is used for any function which requires more than 250 micro-seconds 
to complete. 

8) a) The CPU will exchange to the address specified in the Bi^K portion of the 

instruction, 
b) The CPU will exchange to the address specified in the hardware MA register. 

9) a) PPR. 

b) PMN 

c) The PP will place the value PPR or PMN in the P portion of its exchange package area 

10) a) ART - set up the MSCL parameters for MTR 

b) JAC - check each CP for time slice exceeded 

c) JSW - check each CP active in the CPU fo'r time slot exceeded. 

d) CRC - check each CP in periodic recall for start up, if recall time expired. 

e) PPL - check each CP for a PP routine to start up (RLPW) if PP recall time 
expired. 

11) MTR will drop the queue priority to the lowest queue priority of its origin type and 
will set bit 35 word TSCW off to indicate time slice no longer active If MTR finds 
another CP with a higher or equal CPU priority it will start up CPUMTR. 
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12) It will issue a recall CPU monitor function RCLM, which will call CPTJMTR to set recall 
bit off and W bit on. 

13) CPUMTR. 

14) CPU priority and CPU time slot exceeded then call CPUMTR which will determine 
which CP to give the CPU . 

15) The highest CPU priority If several CPs have the same CPU priority, then they get the 
CPU in rotation. 

16) Need two pseudo CPA with at least 20 words for the exchange package. Assemble two 
routines and absolutize relative to RA+X, where X is the length of the communication 

I area defined. Use LDR to load these two routines and use XJP RA+1 requests. 
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ANSWER TO NO. 3 

1) PPFW It must load at PPFW-5 for the 5 byte header, and if using MS drivers should 1 
not use FL beyond 7000B, 

2) To insure proper running of the system it is necessary to move CP field length in CM. 
A CP cannot be moved while it has PP activity Hence, a PP should pause occasionally 
for this movement. 

3) It is looping on reading its IR. 

4) a> It uses the routine FTN which will place the request in its OR and if possible or 

necessary it issues an MXN . 

b) The request has been honored when the BO in the exchange package has gone to | 
zero. 

c) The request has been completed by monitor when the PPs OR has been set zero 

5) Channels are interlocked by CPUMTR in the channel reservation table in CMR. | 
S) The CP assignment is in its IR byte 2, and PP res will store it in direct cell CP 

7) It uses the DFM routine of PP res 

8) In the direct cells RA and FL, which are set by the PP res routine PRL, which gets 
these values from the STSW word of CP area 

9) It uses the EXR or PLL routine in PP res. Set (A) = routine name, (LA) = load address 
for location free routines . 

10) Set (T5) = est ord and RJM SMS. 

11) POS, WDS, and RDS. 

12) These locations are used for buffers and error processing. 

13) Left to the reader. | 
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ANSWER TO NO. 4 

1) Whenever there is a change in system resources available or time slices or CM time 
slices expire or periodically 

2) RSJM. 

| 3) EPR via AFP checks JCB for interval and integer to add to each queue value in the 
Input and rollin queues. 

4) a) MTR checks for time slice exceeded. 

b) MTR does an RSJM. IS J in routine ERP via AJP will drop the queue priority to 
lowest queue priority for this origin type. 

5) Yes, Yes, Yes 

6) If it finds a new job with a higher queue priority which needs the rollout of a CP to 
get FL. 

7) Highest queue priority which can get FL, after all other jobs scheduled or scheduable 
for rollout has released their FL. If a tie then job with largest FL requirements is 
chosen. 

8) a) 1AJ to start a job. 
b) iRI to roll in a job. 

9) 1SJ calls it into his own PP after issuing an RSJM. 

10) Zero status (ie no activity) on a CP or rollout flag set 

11) 3AA, 3AB, and TCS. 

12) 3AA is called when 1AJ wishes to begin a job. (i.e 1SJ called 1AJ). 3AA will read 
the control cards into the CPA and process the 1st card, processes the job card and 
initiates job processing. 

13) No, TELEX type jobs are always in rollin status 

14) When an error flag is set and 1AJ prepares to advance the job. 3AB will look for an 
EXIT card and if it finds one will continue advancement with the card following the 
EXIT card. 

28-28 97404700C 



15) TCS 

16) CTIME, RTIME. 

17) 1AJ via TCS cracks a control card and uses LDR (or LINK) to load the proper routine 
and request CPUMTR to set its W=l If it is a PP routine call see question 21 . 

IS) It checks the Local FNT entries and when 1AJ finds a match it calls LDR to load it. 

19) It calls LDR 

20) He cracks it and processes it like any other control card (i.e., a call to LDR or PP load). 

21) Yes, TCS uses routine CPP which loads PP into this PP over itself after finding it in 
the RPL or PLD. 

22) See Chapter 2 3 program BOB. | 

23) If you use the job in Chapter 23 with the Control cards following. | 
JOB 

ACCOUNT 

COMPASS 

SYSEDIT 

BOB 

DMP (fl) 

then the SYSEDIT code will be in FL when the card BOB is encountered. Since this 

routine has a DMP- SEP, 1RO will create a DM* file with SYSEDIT on it BOB will | 

run, and when it completes, 1RI will copy the SYSEDIT code from the DM* file back 

into the FL. The DMP will dump the SYSEDIT field length. 

24) DMP has a DMP= SEP so 1RO will create a DM* file with the. SYSEDIT fl and DMP 

will dump the SYSEDIT FL and end. 1RI will copy the SYSEDIT code back into the FL, | 
but there are no more control cards to process so 1CJ will complete the job. 

26) It will create an input queue entry for the subsystem (i.e. an FNT/FST entry type input). 

27) a) It is the collection of FNT/FST entries whose type are PRFT and which are assigned 

to CPO. | 

b) same as (a) except type is ROFT. 
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28) They differ primarily in the FNT entry which is a) jobname for rollout file b) DM* for 
DMP = SEP job The actual DM* file on MS is the same as the rollout file if a full 
rollout dump was requested by the DMP= SEP job 

29) The ACCOUNT card cause the routine ACCFAM to be loaded and it has a VAL= SEP 
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ANSWER TO NO.' 5 

i) SMS loads the proper disk driver into PP resident at location MSD (MSD=S0Q). 

2) FET-+-FNT ■*■ EST -*- MST/TRT. 

3) A sector count is specified when requesting mass storage space so that a track chain 
can be established. (Allocation and deallocation of track chains in done by CPUMTR) 
The number of sectors/track in contained in the MST for any particular device. 

4) RDS - read sector 
WDS - write sector 
POS - position disk 

5) The drop track monitor function (DTKM) is issued after writing a disk file so that any 
unused tracks will be returned to the pool of alloca table tracks. Additionally, the EOI 
sector number is stored in the TRT. 

6) File STIMFL FNT/FST is at location 6720 and 6721. It is type 6=LOCAL. assigned 
to CP 27B, ID=0, 1st track = 243, current track - 243, current sector = 3, status 

is IS = 001 101 means file not busy, open for read, last operation read FNT-EQO-»-EST- 
6600-*-MST-7700: TRACK 243 is 



010 100 



11 = TRT word 50 bvte 3 TRT is MST+20 



7720 - word 50 = 7770 byte 3. The track is 3 sectors long, last sector is EOI So file 
positioned at EOI. (Note: this file is being used by the STIMULATOR) 
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ANSWER TO NO. 6 

1) For a write request, an FNT entry will be created For a read request, EOI status 
is returned in addition to creating an FNT entry. 

2) a) No other PP routine is called by CIO because all mass storage I/O and positioning 

routines are contained in overlays called by CIO. 
b) CIO extracts the function code from the FET, loads an appropriate overlay 
and performs the requested read/write until the operation is complete 

3) Random I/O is accomplished by the user specifying logical addresses of records 
■whereby CIO converts the logical address into a logical disk position of the particular 
record. A random read operation is performed as follows: 

1. User sets FET+6 = logical address of the record desired and issues a random 

read request (in FET -"-(J) 
2 CIO converts the logical address to a random index, positions the disk and 

returns the data. 

4) A re-write in place stores a new record in the same sectors occuppied by an old 
record. An EOI sector is not written for any random write request. A sequential 
write sets EOI. 

5) CIO stops on detecting EOR, EOF or EOI status. CIO will drop if the buffer is full, 
or if FL/100B sectors have been stored in the buffer. 

6) CIO sends a 3-word parameter block to a specific UDT within MAGNET'S FL. 

7) CIO stores the FET address in the control point area word TIOW and TINW and issues 
• monitor function ROCM to roll out the job 

8) Lots. Very careful and extensive modifications are needed. 
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ANSWER TO NO. 7 

1) Control cards processed by RESEX include: 
LABEL 
ASSIGN 
REQUEST 
VSN 
RESOURC 

o\ "pT7 1 CTr'"V :~ — ~ ,_ ~ -,.:-. i .-. «. x ^. ,. . «^j«j- «vin« M ntu ,hu iUn nn/TD- q»~4.«-# «^;«; T , u Q «Qfy-.«Q <-u « 

^ / ituo^A iS 3. apSCicLi cnLlj pOiai pi OgFct.iii w iui iuc j^ivti - cuu v ^^lul . iiici^tuic, liic 

user's job is rolled out to the DM* file prior to loading RESEX After RESEX completes, 
the user's job is rolled back in from the DM* file. 

3) The PREVIEW display informs the operator of outstanding magnetic tape and removable 
pack requests. 

4) RESEX updates the PREVIEW display. 

5) UDT entries are stored in MAGNET'S field length. 

5) The RESOURC control card declares the maximum number of concurrent tapes and 

packs to be used by a job. Depending on the availability of such resources, the job will 
be allowed to continue or will be suspended temporarily. 
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ANSWER TO NO. 8 

1) According to the CMR dump, the first track of the Indirect Access file chain is track 
234 (see byte zero of MST-4 word 7704). Permit buffers start on track 235 (see byte 
2 of MST+4). EST-EQO at 6600-*-MST at 7700. 

2) According to the CMR dump, there is one track allocated to indirect access permanent 
files Pointer is in MST-4 (7704) track is 234 which is word 47 byte 0. There are 

12 sectors and no track links. The total for each user can be calculated by adding 
individual file sizes as stored in the catalog entries. 



3) a) One track is allocated for permit buffers. 235 = |010 011 1)01 1 7720+47 = 7767 

4~" 7 SByte 1 

b) 20 tracks for catalog tracks. All from word 7704 

4) Yes. Three direct access permanent files exist 

5) The user index is set to zero in the catalog, all complete tracks are returned to system 
and the TRT entries are relinked if necessary. If tracks are released then the catalog 
entry is adjusted accordingly. 

6) Holes in the Indirect file chain are not pointed to PFM searchs the holes for an 
exact fit (i.e. same number of sectors needed) and if one exists it is used. If no 
exact fits, then PFM uses the largest hole and creates a new catalog entry with UI=0 
for the residue. If no holes will satisfy the request, then a new catalog entry is 
created for the file 

7) USER*** will have read-only permission for file XYZ. (See page 2-6 of K2. 1 Reference 
Manual) . 

8) Either a semi-private file or a library (public) file can be accessed by any user by 
specifying the permanent file name, the user number under which it was created 
and the password if defined. The system records the number of times the file was 
accessed for either file category. However, for the semi-private file the user numbers 
and last access date and time are also recorded (ref PF control cards in reference 
manual) . 

9) Yes. Indirect access files must reside on the user's MASTER device. Direct access 
files need not reside on the user's MASTER 

10) Yes. Each job has an FNT pointing to the same file. 

11) With indirect access permanent files the user is given a local copy of the file. 
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12) Attaching a direct access permanent file with "write" permission essentially locks 
the file in that no other user can access it until it is returned This prevents two 
users from modifying the file at the same time. However, if any users have attached 
the file in read mode prior to the attach with write, the file cannot be written on 
until all read only users have released the file. 

13) When a direct access permanent file is purged, its track chain is returned to the 
system and its catalog entry is released. 

14) Abort. Yes. To avoid this situation, DEFINE the file prior to writing it. 
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ANSWER TO NO. 9 

1) OVL has 1 entry point. 

ABS has multiple entry points. 

2) Most utility programs need multiple entry points for different functions. 

3) 77 ident table. 

4) a) LINK b) It is loaded by LDR. 

5) a) It will call LDR. (Such as a LOAD an ABS binary file) 
b) It -will process it. 

I 6) LDSET (optional) used for the names of all Libraries to use for satisfying externals. 
PIDL used for program name and length 

7) LDSET, LOAD, MAP, NOMAP, LIBRARY, REDUCE, and SETCORE. 

I 8) a) They are used to satisfy externals. Also a Library can be specified for externals 
in place of the normal Library for the same externals (i.e. different external 

I routines can be linked by the loader other than the standard one. e. g. instead of 

using the FORTRAN library use a user defined library). 

9) Yes, LDSET card 

10) LDR. LDR uses the 2 or 4 word request created by the macro to load the routine in 
I the FL. 

| 11) a) High usage routines can be put on a separate device for quicker access b) Use CMR 
DECK entry ASR = E ord. Use the SYSEDIT directive * AD as shown in section 
11. 3 ASR c) There is no operator command Either change PLD pointer in CMR 
core from the console, or disable the alternate device. 

12) Because different PSR level Libraries may make non- compatible calls to each others 
routines. 
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ANSWER TO NO. 10 

1) Programs comprising the time- sharing subsystem include: 

TELEX/ TELEX1/TELEX2 - CPU routines 1TA, 1TO and iTD - PP routines 

2) The major elements of the TELEX control point are: 

• buffers for data to/ from TTYs (POTs) 
e queues 

• command processing routines 

• queue processing routines 

3) The dynamic memory associated with TELEX is used for POTs. All POT allocation 
and deallocation is controlled by TELEX via a POT Link Table (PLT) which is similar 
to a TRT. 

4) TELEX job flow - 

a) Job initiaition - 

1. TTY operator enters a command. 

2. TELEX calls 1TA to set the user's rollout file to a status whereby it is a 
candidate for rollin. 

3. 1SJ selects the job to be rolled in. 

4. 1RI rolls the job into a control point 

5 1AJ read the next control card and loads the appropriate routine. 

b) Terminal input - 

1. time sharing job issues a read on the INPUT file 

2 CIO issues monitor function ROCM 

3. 1RO rolls out the control point and calls 1TO. 

4. 1TO sotres any data in POTs and informs TELEX of the request for input 
5 TELEX issues "?" to TTY 

6. TTY user enters data. 

7. TELEX calls 1TA to create a rollin queue entry 

8. 1SJ selects this entry 

9. 1RI rolls the job in and transfers data from POTs to the circular buffer. 

c) Terminal output - 

1. The time sharing job issues a write on the OUTPUT file. 

2 CIO calls 1RO to rollout the control point. 

3. 1RO calls 1TO to store data in POTs. 

4. TELEX sends data to TTY. 

5. TELEX calls 1TA to create rollin queue entry 

6. 1SJ selects this entry 

7. 1RI rolls the job into a control point. 
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5) Requests from the driver (1TD) to TELEX are placed in the driver request queue 

Requests from TELEX to the driver are placed in byte 4 of the VDCT word of a terminal 
table entry 

6) PP programs 1TA and 1TO are called by TELEX via a TLX request in RA ^1 (parameters 
are stored in POTs). These PP routines issue monitor functions TGPM and TSEM to 
request TELEX processing. 

7) The reentry table enables TELEX to return control to a subroutine which was suspended 
until a set of conditions were met. 

8) TELEX internal queues are: 

Monitor Request Queues - process TGPM and TSEM requests 

WCMQ - wait for completion of a process 

TIMQ - time delay queue, wait for time to elapse 

JOBQ - perform all job scheduling at one time 

SORQ - perform scheduling of sort jobs 

PP queues - send all 1TA, 1TO and PFM requests 

Driver Request Queue - process driver requests 

9) Information concerning a particular terminal is kept in a terminal table entry within 
TELEX. There is one entry for each known port and each entry is eight words in 
length 

10) A multi- terminal job is a job that performs operation for many terminals and is loaded 
only once. (Currently used for sorting several primary files) 

11) Terminal requests (i.e., driver requests) are processed twice in the main loop of 
TELEX via subroutine DRI. 

12) CPUMTR informs TELEX that the PP request cannot be honored by not clearing the 
PP call word pointed to in the TLX RA+1 request. TELEX increments a count of such 
occurrances and tries later. There is no special case processing done by CPUMTR 
since all TLX requests are handled the same. 

13) The time- sharing subsystem is activated by the operator command: TELEX This causes 
DSD to call IDS. IDS in turn builds an input FNT entry with the name 1TD specified. 

1SJ then calls 1TD to the specified control point (in this case, control point 1). 1TD 
then performs control point initialization and builds a control card buffer in the control 
point area with the following cards: 

TELEX 

TELEX2. 

EXIT. 

TELEX2 
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13) cont 

1TD then calls 1AJ to process the first control card TELEX TELEX initializes tables 
and pointers and loads the main routine TELEX1 . 

14) 1TA requests are grouped together by TELEX to minimize the number of PP calls 
required. 

15) TELEX jobs are scheduled to the rollin queue instead of the input queue since the rollout 
file is available and in fact is created during log-in processing. 

16) So that jobs can be scheduled to the rollin queue instead of the input queue. 

17) The job is rolled out, any output is sent to the terminal and the FNT entry for the 
rollout file is removed from the system FNT. TELEX regains control and has 
the FST entry for the rollout file . 

18) 1TO performs terminal I/O for TELEX as CIO does for batch jobs. However, 1TO 
transfers data between POTs and an RMS device. 

19) 1TD checks for input after each output character is sent to check for an interrupt 
request from the TTY operator. 

20) The reentry address is stored in byte 4 of terminal table word VDPT. This is the 
address within the driver where control is passed during the next pass. 
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ANSWER TO NO. 11. 

1) a) It needs a CP routine for data conversion, and must have a subsystem CP for 

overall communication between the PP routines 

b) It has queue priority greater than MXPS. 

c) It has a very high CPU priority, however, TELEX and the system CP have a 
higher CPU priority and can get the CPU from E200CP. 

2) Function word, status word, message buffer, LINF, CPIK, DPJT or PWLT, FAMT, 
and input and output FETs and buffers . 

3) Via the Function word table. 

4) a) 1LS 

b) a PP must set up the subsystem status, CPA and Fl. 

c) IDS builds the input queue entry for 1LS. 1SJ will start 1LS with a CP 
assigned, and 1LS will build the CPA and initialize the FL. 

5) While 1ED is transmitting print data or receiving card reader input to the 200 UT, 
it will monitor the keyboard. All entries from the keyboard are ignored except the 
interrupt key If 1ED senses the interrupt key, it will stop transmitting and receive 
input from the keyboard. At that time the 200 UT operator can type END, CR or LP 

6) XSP will a) process job drop requests, b) Log in terminal processes, c) make 
initial input queue entry. 

7) CIO. 

8) See overview diagram Step 1,2,3,4, and 5. 

9) See overview diagram Step 6, 7, 8, and 9. 

10) Compares Jobname from FNT with LINF table. 
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ANSWER TO NO 12. 

1) HO, 1CD, 1BA. 

2) For PP communication, FETs and buffers. 

3) It has queue priority greater than MXPS. 

4) HO is the only PP and it is in PP recall via the RLPW word in the CPA 

0/ it. Ca.xla K,L\y . 

6) 1IO calls 1CD calls 1BA to create an input queue entry (i.e. an FNT/FST entry of 
type INFT) . 

7) The LPxx, yy or LQxx, yy command will place yy in the unit field of the EST at 
ordinal xx if it is an LP or LQ type Then BATCHIO will compare the ID field (if 
not zero) of the output queue entries to the LP and LQ devices until it finds a match 
in the unit fields . 

8) They are used by 110 to determine how many function each copy of 1CD is processing 

9) a) The DRQR is used to request a function from 1CD 

b) 1CD compares its DCW offset in its IR against the DCW offset in the DRQR 

10) When the p bit of its IR is zero. 
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ANSWER TO NO. 13. 

1) So that they can input all of their FL before being released from the 1AM instruction. 

2) They are hung on an IAM channel, 0; where channel number corresponds to PP number 

3) PRL is coded to expect them in that order. 
I 4) It is read into PPO word 1 thru 14. 

5) It builds the PPULIB, RPL, RCL, PLD and CLD. 

6) It contains all the PP routines not in the RPL. The PP routines have their 77 table 
stripped from them, but the complete PP routines still reside on the SYSTEM file 
The PLD points into the PPULIB file. 

7) a) STL issues an RSJM monitor function 
b) to start scheduling of the system. 

8) KRONOS always recovers, the different levels only impede the process in some way. 
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ANSWER TO NO. 14. 

1) When it must perform a function for a particular CP. Such as enter data into CM, but 
does not include overlays displays for a particular CP such as K,n. 

2) When DSD must perform some function it cannot do it calls IDS to perform it. 

3) No, they build one line of display at a time; and the main loop displays that line. 

4) DSD senses X.DIS and finds an available CP. DSD calls IDS which calls DIS into its 
PP with the CP assignment made by DSD 

5) They sense "* " from the keyboard. If "* " is sensed as the 1st character, they will 
release the channel. When not connected to the channel they periodically check the 
EST ordinal for device DS and when it is available (the CP assignment is 0) they 
will request the channel via RCHM monitor function. 
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ANSWER TO NO. 15. 

CMRDCK1 

NAME = CDI KRONOS 2.1 TIME-SHARING SYSTEM 

NCP = 10. 

FNT .= 1300. 

EQO = DB, ON, 1,0,0 

EQ1 = DB.ON, 1, 1, 1. 

EQ2 = DI-2.ON.0.0, 2, 3, R 

EQ3 = DI-2,ON,0,2,2,3,R. 

EQ4 = DI-2,ON,0,0,4, 5,R. 

EQ5 = DI-2.ON,0,2,4, 5,R. 

EQ6 = DD, ON, 4,0,6. 

EQ7 = DP, ON, 2000, 20. 

TEMP = 0, 1 . 

FAMILY = 2. 

PF = 2,D, 125,FAMX,40 

PF = 3,D,252,FAMX,41. 

REMOVE, 4, 5,6. 

ASR -- 7. 

EQ10 = DS.ON, 7, 0, 10 

EQ11 = CR,ON,3,0, 11. 

EQ12 = CP.ON, 5, 0, 11. 

EQ20 = LP, ON, 6, 0,22. 

EQ30 = ST.ON, 7,0, 24. (6671 for EXPORT) 

EQ40 = TT, ON, 5, 0,23,50. 

EQ41 = TT, ON, 4,0,26,0, 10. (6671 for TELEX) 

EQ50 = MT-3,ON, 5, 0, 12. 

EQ60 = NT-2,OFF, 6, 0, 13. 

EQ76 = TE, ON,,, . 

EQ77 = NE.ON,,, . 
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APPENDIX A 
GLOSSARY 



ABS 


Absolute 


DFM 


Dayfile Message 


ABT 


Abort 


DT 


Device Type 


-HO 


ft — *. TVT \ _. 






ACP 


Advance Control Point 


E 


Executive (Also CPE) 


AL 


Alternate Library 


ECP 


End Central Program 


ARB 




ECS 


Extended Core Storage 


ARBS 


Accounting Record Block Size 


EF 


Error Flag 


ARS 


Alternate System Residency 


EFN 


Enter File Name 


ART 


Advance Running Time 


EM 


Error Modes 


ASR 


Alternate System Residency 


EOF 


End of File 


ATX 


After Exchange Jump 


EOI 


End of Information 


AVC 


Advance Clock 


EOR 


End of Record 


AUN 


Alternate User Number 


EP 


Exchange Package 






EPA 


Exchange Package Area 


B 


Binary Requested 


EPT 


Entry Point 


B 


Octal Number 


EQ 


Equipment 


BCE 


Begin Control Point Executive 


EST 


Equipment Status Table 


cc 


Command Code 


FE 


Fatal Error 


CBP 


Check Buffer Parameters 


FET 


File Environment Table 


CCE 


Create Catalog Entry 


FL 


Field Length 


CCP 


Check Central Program 


FM 


File Managers 


CEJ 


Central Exchange Jump 


FNT 


File Name Table 


CFA 


Check File Access 


FP 


First Pot 


CH 


Channel 


FST 


File Status Table 


CIO 


Combined Input/Output 


FWA 


First Word Address 


CLD 


Central Library Directory 






CM 


Central Memory 


HNG 


Hang 


CMR 


Central Memory Resident 






CMS 


Copy Mass Storage 


ID 


Identification 


CP 


Control Point 


IDL 


Idle Loop 


CPA 


Control Point Area 


IIQ 


Initial Input Queue 


CPE 


Control Point Executive (Also E) 


rvrf 


Initialize 


CPR 


CPUMTR Request Processor 


IOQ 


Initial Output Queue 


CPS 


Control Point Status 


IQ 


Input Queue 


CPU 


Central Processor Unit 


IQP 


Initial Queue Priority 


CPUMTR 


Central Processor Unit Monitor 


IR 


Input Register 


CRC 


Check CPU Periodic Recall Status 


IRQ 


Initial Rollout Queue 


CRR 


Check' Rollout Request 


ISR 


Identify Special Reques 


CSF 


Check Special Format 






cue 


Check User Controls 


JAC 


Job Activity 






JCA 


Job Control Area 


D 


Decimal Number 


JSW 


Job Switching 


DDP 


Distributive Data Path (ECS) 






DFD 


Dayfile Dump 


KTS 


KRONOS Transaction Su 
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GLOSSARY (Continued) 



LCP 


Load Central Program 


RESEX 


LDB 


Load CM Buffer 


RCH 


LFM 


Local File Manager 


RCL 


LFS 


Location -Free Subroutines 


RDS 


LIQ 


Lower Input Queue 


RI 


LOQ 


Lower Output Queue 


RJC 


LP 


Last Pot 


RMS 


LQP 


Lowest Queue Priority 


RO 


LRQ 


Lower Rollout Queue 


RPL 


LWA 


Last Word Address 


RTS 


MA 


Monitor Address 


SAF 


MAGNET 


Magnetic Tape Executive 


SCP 


MB 


Message Buffer 


SED 


MEJ 


Monitor Exchange Jump 


SEP 


MF 


Monitor Flag 


SFJ 


MM 


Monitor Mode 


SFP 


MS 


Mass Storage 


SFS 


MSD 


Mass Storage Driver 


SIB 


MSG 


Message 


SL 


MST 


Message Storage Table 


SLM 


MTR 


Monitor Peripheral Processor 


SLP 
SLT 


NFN 


New File Name 


SMS 
SN 


OQ 


Output Queue 


SRP 


OR 


Output Register 


SS 


OVL 


Overlay 


SSF 
SSP 


PCW 


Program Control Word 


SSS 


PF 


Permanent Files 


SUN 


PFM 


Permanent File Manager 




PFN 


Permanent File Name 


TCS 


PGM 


Program 


TELEX 


PLD 


Peripheral Library Directory 


TFS 


PLL 


Peripheral Library Loader 


TRT 


PLT 


Pot Link Table 


TRANEX 


PMS 


Position Mass Storage 


TI 


POS 


Position Disk 


TIO 


PP 


Peripheral Processor (Also PPU) 


TO 


PPC 


PP Communication Area 


TLD 


PPR 


PP Resident 


TN 


PPU 


Peripheral Processor Unit (Also PP) 


TT 


PRU 


Physical Record Unit 




PTX 


Prior to Exchange Jump 


UDT 
UFS 





Queue 


UI 


QP 


Queue Priority 


UIQ 
UOQ 


RA 


Random Address 


UQP 



Resource Executive 

Reserve Channel 

Resident Central Library 

Read Sector 

Rollin 

Read Job Control 

Rotating Mass Storage 

Rollout 

Resident Peripheral Library 

Request Task List 

Search for Assigned Files 

Sub Control Point 

Set Equipment Definition 

Special Entry Point 

Search for Job 

Special Function Processor 

Set File Status 

Search Index Block 

System Library 

Sector Limits 

Set Load Parameters 

Search Library Table 

Set Mass Storage 

Sector Number 

Special Request Processor 

Sub System 

Search for System File 

Set Statistical Parameters 

Sub System Subroutine 

Search for User Number 

Translate Control Statement 

Time -Sharing Executive 

Tree File Structure 

Track Reservation Table 

Transaction Executive 

Time In 

Terminal Input/Output 

Time Off 

Task Library Directory 

Terminal Number 

Terminal Type 

Unit Descriptor Table 
Update File Status 
User Index 
Upper Input Queue 
Upper Output Queue 
Upper Queue Priority 
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GLOSSARY (ConHnued) 



URO Upper Rollout Queue WC Word Count 

WCB Write Central Buffer 

VUN Verify User Number 

XF Execute Flag 
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APPENDIX B 
KRONOS 2.1 GENERAL OVERVIEW 



LEGEND 

1 . Solid Horizontal line ►direct call 

2. Dashed Horizontal line ►return of control 

3. Solid vertical line upward j external of helper routine 

4 . Solid vertical line downward I overlay 

5 . Downward double line J j routine completely overlays caller 

6. Circle is PP routine 



7 . Square is CP routine 

8 . is zero 

O is alphabetical O 

9 . UI is user index 

10. CP is control point; CPA is control point area 

11. Solid double vertical line double headed J £ routine calls overlayed routine back 







12. FL is field length 

13. MS is mass storage 

14. EST is equipment status table 

15. EF is error flag 

16. XXX is PP routine name, XXXXXXX is CP routine name 

17. SEP - special entry points 

18. PBA field in SPCW of CPA indicates 20 word parameter block 
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INPUT 

I. BATCHIO (BCOT) 




1. RLPW in CPA activates executive 

2. DRQR request queue activates driver which reads one sector from card reader 
to CM buffer. 

3. Driver calls 1BA to initiate job 

4. OBF creates FNT/FST entry 

5. 2TJ cracks job card and 

a . writes job card information 

b. generates job name + RJSM 

c. creates system sector 

6. Copy first sector from CM buffer to input MS file 

7. Driver copies rest of cards to CM buffer 

8 . CIO copies from CM buffer to INPUT MS file 
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A . INPUT (Continued) 

TT TTTCT ^TVf~lT\ 

i 4. » 4. 4_1 ±Jl^Jt UJ\ \^ J. I 




Driver transfers login data to TELEX 

TELEX 1 sets up ITAQ for jobs destined for a CP. 

Validate user and set UI. (1TA log in function) 

ITA builds a ROLLIN/ROLLOUT queue entry for user 

a. generates job name via COMPGJN 

b. creates system sector 

c. creates FNT/FST entry in terminal table 

d. all locai files will be carried in the ROLLOUT file for 1RI to create 

e. create FNT/FST entry for above (when job is destined for a C.P.) (Does 
not use OBF) 
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INPUT (Continued) 

III. EXPORT/IMPORT (EIOT) 




1 . Driver receives activity from remote card reader and starts CP routine. 

2. CP routine starts executive 1LS and transfers data from 1ED buffer to CIO 
buffer. 

3. Executive calls job card processor 2TJ to put job priorities into FET+7, 
generate job name and calls input file processor XSP. 

4. Same as BCOT step 5 except append RJSW to 1LS generated job name. 

5 . Generate system sector 

6. Create FNT/FST entry 

7 . Copy rest of input data to MS file . 
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INPUT (Continued) 
IV. CONSOLE (SYOT) 



..xxxxxxx. 





3. 

4. 



Process operator command 

a. if control card call, call IDS function 17-1CJ 

b. if subsystem call, call IDS function 17-1CJ 

a. 1. if PP call see 4 

2 . generate job name and start CP job 

b. generate subsystem input queue entry and system sector 

Generate FNT/FST entry 
Call PP requested directly 
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JOB FLOW 

I. SCHEDULER (1SJ) 

1. Startup. 



J — RSJM- 
/ from 
( Pool PP on 
MTR 



\ M 




i . iSJ is started only by CP JMTR in response to RSJM and controlled by 
CMR words JSCL and JSCL+1 . 

2. Locate job in INPUT or ROLLOUT queue with largest queue priority 

a. get CP 

b. get FL 

3. ISP is periodically called to check on MS and age priorities. 

4. Update MST/TRT for MS specified by checkpoint requested bit in EST 

5. Update removable MS and process INITIALIZE requests 

6. a. Initialize CC buffer (position to second card i.e., ignore job card) 
b. Set VAL = bit 17 in UIDW if ACCOUNT/VALIDATION enabled from 

CMR word SSTL 

7 . Initialize CPA. 

8. Go to VALIDATION or NORMAL processing depending on ACCOUNT/ 
VALIDATION enabled. 
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JOB FLOW (Continued) 

2 . Continuation 



RSJM 




kulujUT queue 
entry 



1SJ 




3,4,5 



1,2,3,4,5 same as start up 
6. Roll job into CP. 
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JOB FLOW (Continued) 
II. ADVANCEMENT 
1 . Job Error 



Pool PP 
' or CPUMTR 
VsetsEF-CEFM; 
JACM 




<D. 



JACM sets job advancement flag and calls 1AJ. 
Check EECW and STSW (error flags) in CPA. 
Analyze error and issue error message. 

a. If reprieve or user control on errors, return to user 

b. EXIT card processing 



Termination 



I MTR \ 

/ W=X=R \ 
\ Status -i } 




Last CC completed and MTR finds advancement status = 
1AJ discovers EOR on CC statement file 

Complete job 

a. dispose OUTPUT files, append dayfile and change SYOT to BCOT. 

b. release CP and FL 

c. Complete job accounting UADM 

4. Drop all local files 

5. Update resource files (RESEXDF and RESEXVF) 

6. -Release permanent files. 
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B, JOB FLOW (Continued) 
3 , Normal 



/ \ 

JACM 




riAi 



fxxx\ 



A 



\> 



LDR = 
6 



Same as termination step 1 . 

1AJ verified that CC statement buffer is not at EOR. 



TCS a. processes next CC 

b. locate RPL, PLD, CLD entry or $LDC call. In fact 1AJ 
never explicitly searches the RCL it finds all RCL entries 
in the CLD. 

c. Crack arguments if no ARG = 

d. CC dayfile message if no SDM = 

4. If a PP call, load PP routine 

5 . Process ABS CP program load (see next page) 
process RFLOR MFL=if present. 

6. Process REL CP program load (see next page) . 
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JOB FLOW (Continued) 



START , 



Read a 
control card 



© 



0- 



Control card ~ 
processor 
searches its list 
of control card 
names for speciai 
control card 



Process 

special 

request 




Use KRONOS 
format for 
processing 
parameters 



Search FNT 
for file 
assigned to 
this job 




yes 



no 



Search CPU 
library for 
control card 
name 




Search PP 

library for 
name, if name 
is legal PP 
progr am name 




yes 



Declare 
control 
statement 
illegal 



© 



Process field 
length control 



T 



Load program 
to central 
memory 



Store control 
statement and 
control statemenl 
arguments in 
user's FL com- 
munication area 



f Execute\ 
vprogrami 



Place name 
with up to two 
octal arguments 
as a PP request 



Exit to pro- 
'gram (no FL 
change) 



Local absolute files with multiple entry points cannot be 
loaded. However, local relocatable files with multiple 
entry points can be loaded. 







Denotes change for KRONOS 2. 1 



'Load routine only if it. is ABS/OVL, else declare illegal cc, 
Control Card Processing 
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B. JOB FLOW (Continued) 
4 . Rollout 



Pooi PP 

MTR or 1ST 

ROCM 




1 . ROCM sets the rollout bit STSW in CPA 

2. 1AJ finds rollout bit set 

3. 1RO can only be called by 1AJ 

a. Create rollout file 

b. Create system sector 

4. Create special FNT/FST entry (if needed (DM*) 
Special Entry Points (DMP = , SSJ=) 





/lA M no DMP= 
4. 

DMP = 
only 



1 . Cause loading of xxx or default loading of SFP . 

2 . Set up SPCW work in CPA 

3. Normal CC processing (notice it's an SEP) 

4. Set up SEPW word in CPA from SEPA word in CLD 

5. Set up DM* file according to DA field in SEPW & process PBA if 
non-zero. PBA is only available with DMP=SEP. 

6. If SSJ= set up SSJ = CPA areas from SA field in SEPW 

7 . Load ABS CP program 



97404700D 



B-ll 1 



VALIDATION (VAL=) 

I. TXOT - See INPUT. 

II . BCOT/EIOT 

Step 1 . Begin job time 



from STEP 

8 Schedular 

start up 




VAL= 

CP 

Program 

4 



1 . 1AJ verified that CC statement buffer not at EOR 

2. Process next CC - see step 3 of NORMAL ADVANCEMENT. 

3. Verify that CC program call has VAL=SEP in SEPA of CLD 

a. load program if VAL= 

b. set EF if no VAL=, abort CP and issue error message 

4. VAL= CP program loaded must be ACCFAM (called by ACCOUNT CC) or 
CHARGE (called by CHARGE CC) since no other routines exist in KRONOS 2.1 
as of June 1974. 
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C. VALIDATION (VAL=) (Continued) 
Step 2 . 




1. 

2. 
3. 

4. 

5. 



CHARGE if loaded will abort CP since UI=0 in CPA. 

ACCFAM has an SSJ= SEP so it can use UI = 377777B and attach VALIDUX file. 

CPM in VALID mode will set UI from OAV. 



OAV will validate user on VALIDUX file. 
if not verified 
value if verified 



UI= 



Place Validation parameters in CPA or abort user with message if UI=0 

a. set VAL= flag in UIDW off if CCNR in AACW in CPA indicates CHARGE 
card unnecessary, via SSJ= param block 

b. subsequent ACCFAM calls will only reset UIDW word, via SSJ= param 
block, all other verification areas in CPA remain unchanged. 



Step 3. 

Ignore if CCNR in AACW on, indicating CHARGE processing unnecessary. 
Else same as Step 1 . 

Step 4. 




If ACCFAM loaded again see Step 2 point 5b. Else CHARGE must be loaded 
since only ACCFAM and CHARGE have VAL= SEPs. 

wiiru-ivjt, uoa aoj - atr 5u ii. wan use ui = 0/////B ana aitacn r'KOfi.LU iue, 

a. validate user or abort user with message if validation fails. 

b. set VAL= flag clear in UIDW via SSJ= param block 

c . there are no COA areas for charge system 

d. subsequent calls will only issue charge and project number to the 
account dayfile 

e. set up accounting dayfile message for charge and project number 

Special charge functions - but no change to CPA. Issue message from e. 
Set no charge required for TXOT origin jobs in VSTT word byte bit 56 of 
TELEX FL. 
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C. VALIDATION (VAL=) (Continued) 

III. SYOT does not need to be validated in order to run. (i.e. , VAL=bit in UIDW is 
never set) . 

D. OUTPUT 

I. TELEX (TXOT) 




TELEX1 
6 




1TD\ 



TTY 




1 . Job completes 

2 . See Termination in ADVANCEMENT 

3. 1CJ discovers that this is a TXOT type and that TELEX is active so it calls 
1RO, Else see Termination in ADVANCEMENT . 

4. 1RO rolls job out creates rollout file (but no FNT/FST entry) and sets termi- 
nal table entry via COMPGTN 

5. 1TO transfers any output data to TELEX1 if any. (3 POTs at a time). 

6. TELEX1 tells 1TD about OUTPUT if any 

7. 1TD transfers OUTPUT or results of job info to user on TTY 
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D. OUTPUT (Continued) 
II. SYOT/BCOT 





III. 



2. 
3, 

4. 
5. 
6. 
7. 

EIOT 



OUTPUT entry in FNT/FST of type BOOT (SYOT will be changed to PCOT by 1 
1CJ) 

Find OUTPUT queue entry with highest queue priority 

DRQR request queues activates driver 

Read first sector of OUTPUT file to CM buffer 

Create banner page via 3BB . 

Copy first and subsequent sectors from CM buffer to printer 

Copy subsequent sectors from MS to CM buffer 




1. OUTPUT fiie entry in FNT/FST of type EIOT. 

2. 1LS executive finds OUTPUT entry with highest queue priority 

3 . 3BB creates banner page in CM buffer 

4. E200CP transfer data from CIO buffer to 1ED buffer 

5 . Copy rest of MS OUTPUT file to CIO buffer 
6 . Transfer data to 200 UT 

7 . Print output on remote printer 
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MULTI -TERMINAL (MTOT) 

I. TXOT (only primary file sort jobs are defined as MTOT type as of June 1974) . 
1 . Initiation 




^y-Q 



i. 

2. 
3. 

4. 



Terminal(s) request primary file sort either directly or indirectly 
Set up ITAQ 1TA queue 

a. 1TA sets up a Rollin/ Rollout file of type MTOT and system sector 

b. Create FNT/FST for above 

c. Enter primary FNTs from TELEX pot. 



Control card will be placed in CPA 
Control card buffer CSBW by 1AJ 
(3AA routine BMT) from a TELEX pot. 



Completion 




1AJ 




MTOT type job completes normally 

1AJ detects EOR on Control Card record 

1CJ finds MTOT type and finds that TELEX is active else complete job 
as in ADVANCEMENT Termination 

1RO sets terminal tables for affected terminals waiting on SORT and 
does not create a Rollout file - Sets error or complete status for files to 
be sorted in Terminal Table. 



II . BCOT/EIOT/SYOT 

1. MTOT type jobs are not defined. 
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APPENDIX C 
CYBER 170 STATUS AND CONTROL REGISTERS 



INTRODUCTION 

In order to accomplish this end, several PP routines were modified and written to use the hard- 
ware. Since NOS can be deadstarted on any 6000 type machine, the system must be able to 
recognize and utilize the available hardware. In order to recognize a CYBER 170 machine, the 
system must determine if the Status and Control Register (SCR) exists. At deadstart, SET will 
status the SCR by active test on channel 16 (if active SCR exists). SET will also determine if 
SCR exists. During system operation, MTR will call 1MB to monitor the SCR and utilize the 
facilities contained therein. 

The facilities include: 

• Unhangable channel commands 

• Unhangable PP to CM reference 

• Memory parity both CM and PP 

• Channel parity 

• SECDED memory error detection 

• Individual PP deadstart 

• Double speed PPs 

• Etc. 

The key to using these facilities lies in the use of the SCR. All of the following information 
has been obtained from the following manuals: 

• CYBER 170 Model 175 

• Hardware Reference Manual Input/Output Specs 

The glossary defines the terms used in this package. 

CEI Central Exchange Jump 

CM Central Memory 

CMC Central Memory Control 

CP Central Processor 

CPU Central Processor Unit 

CSU Central Storage Unit 

ECS Extended Core Storage 
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EM Exit Mode 

FLC Field Length for CM 

FLE Field Length for ECS 

I /0 Input/Output 

MA Monitor Address 

MEJ Monitor Exchange Jump 

MF Monitor Flag 

MOS Metal Oxide Semiconductor 

P Program Address 

PP Peripheral Processor 

PPM Peripheral Processor Memory 

PPS Peripheral Processor Subsystem 

RAC Reference Address for CM 

RAE Reference Address for ECS 

RNI Read Next Instruction 

SECDED Single -Error Correction, Double Error Detection 

The hardware is designed with up to 2 62K words of memory distributed over up to 2 chassis 
called Central Storage Units (CSU) . Each CSU can be accessed by a Central Memory Control 
(CMC), A system can have only one CMC, and only two CPUs maximum. Each CMC then 
has 5 ports for CM access, as shown in figure C-l. These CSU units are called chassis and 
are placed physically in bays as shown in figure C-2 for a Model 175. The logic diagram 1 
in figure C-2 shows that for any chassis to access central memory CSU, it must interface 
via the CMC. 

Figure C-3 shows the CMC error communications. 
Figure C-4 shows the central memory address format. 
Figure C-5 shows the CYBER 170 DS panel. 
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CMC 



PPS-0 



▼ 
PPS-1 



▼ 

CSU-0 



CSU-1 



ECS 
Cntrl 



The CMC can have 2 CPU ports 
and 5 other ports. 



Figure C-l. CMC Ports 
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131K CSU-1 

























3 Bays 
3 Chassis 



Logic Diagram 1 
PPS-1 to Mem Chassis 1 



CPU 



PPS-1 



131K 



PPS-0 to Mem Chassis 



CPU 


c 

M 
C 




PPS-1 










131K 





All memory requests routed via CMC. 



Figure C-2. CYBER 175 Configuration 
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CMC 



CMC INPUT ERROR FLAG 



DOUBLE ERROR FLAG 



BREAKPOINT FLAG 



DATA PARITY ERROR 



REQUESTING 
PORT 



CM ADDRESS PARITY ERROR 



^^q/n i*»#-»r^r- Akin rv A TA rtA niTv 

itRu ^uuc/hi\u umim rAni i i 



ZERO ADDRESS PARITY TO CM 



BREAKPOINT ADDRESS 



BREAKPOINT PORT CONTROL 



■©- 



.BREAKPOINT ACCESS CONTROL 



BREAKPOINT FLAG 



OH 



BREAKPOINT ACCESS CODE 



BREAKPOINT OR INPUT PARITY PORT CODE 



CMC INPUT PARITY ERROR FLAG 



O- 



ADDRESS/DATA PARITY ERROR 



CM ADDRESS PARITY ERROR 



SECDED ERROR FLAG 



SINGLE/DOUBLE ERROR 



SYNDROME CODE 



SECDED ADDRESS CODE 



<S> 



-> 



CM 



CONTROL 
REGISTER 



STATUS 
REGISTER 



Figure C-3. CMC Error Communications 



3ARIA 
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CENTRAL MEMORY 

ADDRESS FORMAT 

The 18-bit CM address is partially translated in CMC to a 14-bit address and 16 separate go 
bank signals. The translation is somewhat different for the models 172/173/174 and the 
model 175. On the models 172/173/174, bits 0, 1, 2, and 17 are used for bank selection. 
On the model 175, bits 0, 1, 2, and 3 are used for bank selection. In each case, the most 
significant bank select bit actually selects one of the two CSU chassis. The address formats 
are shown in figure C-4. 



PB 



15 



14 



PARITY BANK QUAD 
BIT SEL SELECT 



13 



12 



10 9 



CELL ADDRESS 



3 2 



- / Sr^ r 

CHIP BANK 
SELECT SELECT 



MODELS 172/173/174 



PB 


17 


16 


15 


14 


13 


12 


II 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 






PARITY QUAD 
BIT SELECT 



CELL ADDRESS 



CHIP 



— V 

BANK 

SELECT SELECT 



J 



MODEL 175 



Figure C-4. Central Memory Address Formats 



DATA FORMAT 

Central memory is capable of sending and receiving 68 bits of information. The 68 bits are 
comprised of 60 bits of data plus 8 SECDED code bits which are added and checked as the data 
is passed through CMC. The data format is shown below. 
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Figure C-5. CYBER 170 Deadstart Panel 
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STATUS AND CONTROL REGISTER 

The status and control register provides control of the new features without impacting current 
software. It is permanently hardwired on channel 16 . It has bit assignments to monitor the 
parity error and SECDED networks. It also is the source of control for testing these networks. 
Additional controls are provided for the breakpoint feature, PP speed enhancement, and main- 
tainability features. 

An additional abridged status /control register is present in a 20-pp system. It is contained 
on the second PPS chassis and contains only those bits that affect the additional PP's. The 
channel assignment is 36 . There is also a bit in the prime status register that indicated a bit 
set someplace in the second register. This allows only one test to interrogate both registers . 

Channel 16 is an internal channel and is always active. This channel has a 12 -bit output 
register to hold a descriptor word sent from a PP. It also has a 12-bit input register to hold the 
status information to be read by a PP. An output will set the channel full , thus keeping any 
other PP from doing an output on this channel. An input must be done to clear the full after 
the output. This frees the channel for usage by the other PP's. To maintain consistent control 
of this channel, all software routines that access the status and control register channel must 
provide an output followed by an input . 

The descriptor word sent from a PP contains the function and an address to designate the 12 -bit 
word or single bit on %vhich the function is to be performed. 



Instruction Code 

2000 (LDC yxxx) 

yxxx 

7216 (OAN ch 16 or 36) 

7016 (IAN ch 16 or 36) 

where y = function 

and xxx = word or bit address 



Descriptor Functions 

Oxxx read 
lxxx test 
2xxx clear 
3xxx test/clear 
4xxx set 
5xxx test/set 
6000 clear all 
7000 test error 



Description Word 



Function 
Code 


Not 
Used 


Word or bit address 



11 



A read function translates xxx as the word address and selects the 12 -bit word to be placed in 
the input registe r. For the other functions, xxx is translated as a bit address and selects the 
bit on which the function will be performed . A test function reads the bit that is selected and 
places it in the lowest order bit position of the input register. A set function forces the appro- 
priate bit to a one, and a clear function forces the bit to a zero. The test/set and test/clear 
functions first read the selected bit and then either set or clear the bit as requested. The 
clear all function forces all the bits in the status and control register to a zero. A deadstart 
master clear also clears all the bits in the status and control register . The test error function 
performs a logical OR test of the lowest order 40 bits, which includes all the, error flags of the 
status register. This allows a software routine to determine, with this single test, whether or 
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97404700D 



not an error has been recorded in the status register. Further interrogation can then be done to 
determine the actual error status . 

Because there is no provision in the status and control register channel for writing a 12 -bit 
word, all of the control bits must be set individually with a set function. 

Light modules containing light emitting diodes (located on the PP chassis) provide a visual 
display of each of the status bits of the status and control register. 

Programming considerations for the status and control register, channel 16 (and 3 6) are as follows: 

Instruction 

AJM 64 Not needed because the channel is always active. 

IJM 65 Not needed because the channel is always active. 

IAM 71 Hangs the PP with channel empty if more than one word is input. 

OAM 73 Hangs the PP with channel full if more than one word is output. 

ACN 74 Hangs the PP because the channel is always active. 

DCN 75 Executes, but does not disconnect the channel; becomes a two trip pass. 

FAN 76 Hangs the PP because the channel is active. 

FNC 77 Hangs the PP because the channel is active. 
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1 
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10 
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2 
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S 


S 


S 


S 


S 




S 


S 


s 


s 




TE 


TE 


TE 


TE 


TE 


TE 




TE 


TE 


TE 


TE 










X 


X 












X 




X 


X 


X 


X 


X 


X 




X 


X 


X 


X 


























Not 
Used 


Error 
in 

2nd 
PPS 


CSU-1 
Fault 


CSU-0 
Fault 


Inter 

PPS 

Parity 


Inter 

PPS 

Parity 


CMC 
Parity 
Error 


Not 
Used 


SECDED 

Error 


CSU-1 

Address 

Parity 

Error 


CSU-0 

Address 

Parity 

Error 


Read 

Pyramid 

Parity 

Error 








Tests thru 39 


of PPS-1 










Loads and Locks 




Loads and Locks 





Bits 54. 55, 139. 
140, 183 



Bits 40 thru 53 



PPS 

csu 

SECDED 
Display 
Chan 36 
S/C 
Functions 



PP Subsystem 

Central Storage Unit (Controller) 

Single Error Correction, Double Error Detection 

LED Display on Chassis 

For access to 2nd bank of PPS, i.e., PPS-1 PP # 20 t 32 abbreviated SCR 

Status or Control 

Blank .... read, test, clear, test/clear, set test/set and clear all. 

TE .... same as Blank plus TEST ERROR part of the test error function. 

D .... same as Blank but cleared at Deadstart. 

R .... Read only! 
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4i 
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o 
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CHAN 36 
DISPLAY 
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S 
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X 
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X 


X 


X 1 X 
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PP7 


















PP9 

Memory 

Parity 

Error 


PPiB 


PP6 


PP5 


PP3 


PP2 


ppi 


PPO 

Memory 

Parity 

Error 


CPU-1 

p 

Register 
Parity 
Error 


CPUO 

p 



RNI parity 
from CSU 



o 
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24 


43 


42 


41 
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37 


36 


35 


34 


33 


32 


31 


30 
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S 


S 
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S 
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S 


S 


S 


S 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


TE 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
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13 
Parity 
Error 


12 


11 


10 
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6 


5 


4 


3 


2 


1 


Channel 



Parity 

Error 
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BIT DECIMAL 


47 


46 


45 


44 


43 


42 


41 


40 


39 


38 


37 


36 


BIT OCTAL 


57 


56 


55 
S 


54 


53 


52 


51 


50 


47 


46 


45 


44 


S/C 


S 


S 


S 


S 


S 
R 


S 


S 






S 


S 


FUNCTION 


R 


R 


R 


R 


R 


R 


R 






TE 


TE 


CHAN 36 






X 






X 














DISPLAY 


X 


X 


X 


X 


X 


X 






X 


X 


WORD 
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Syndrome 
Bit 
7 


6 


5 


4 


3 


1 


Syndrome 
Bit 



Not 
Used 


Not 
Used 


Power 
Shut- 
down 
imminent 


Main 
Power 
Failure 


3 








k 






Loade 
Lock 






J 


Power /Environment 
Abnormal Condition 










d and 
ad by 












Memory SECOEO Error 

Clear Bit 3 unlocks these bits 

See Figure C-6 
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The SECDED code is generated when written to CM and is appended to the 60 bit data word. 

On read, the SECDED code is regenerated and a logical difference is made with the SECDED 
appeded to the 60 bit data word. This creates the SYNDROME codes shown below. 



CODE (BIT ! 


CODE 


BIT ! | COI-E 


BIT ! i CODE 


BIT j 


CODE 


BIT i ICUDI 


hit 


CCDF 


BIT 


cor^E 


BIT 


000 


©; 


040 


© 


| ICO 


© i j HO 


© 


200 


© 


240 


©.' 


300 


© 


340 


50 


001 


© | 


041 


© 


1 10'. 


© | | 141 


53 


201 


© 


241 


57 


301 


58 


341 


© 


002 


© ! 


04 2 


© 


102 


© 


142 


54 


202 


© 


242 


59 


302 


© 


342 


© 


003 


© i 


043 





103 


1 


j 143 


© 


203 


2 


243 


© 


303 


© 


343 


© 


004 


© 


044 


© 


104 


© 


I '« 


40 


204 


© 


244 


© 


304 


© 


344 


© 


OOS 


© 


045 


23 


105 


3 ! 145 

1 i 


© 


205 


5 


245 


© 


305 


© 


j 345 


© 


00< 


© 


04 6 


22 


106 


8 j ! 146 


© 


206 


9 


246 


© 


306 


© 


j 346 


© 


007 


10 


047 


© 


107 


© | | 147 


© 


207 


© 


247 


44 


307 


® 


347 


© 


010 


© 


050 


© 


no 


© j | 150 


41 


210 


© 


250 


43 


310 


48 


350 


© 


on 


© 


051 


47 


111 


7 | 1 151 

1 1 


© 


211 


6 


251 


© 


311 


© 


j 351 


28 


oi: 


© 


032 


27 


j 112 


31 | | 152 


© 


212 


11 


252 


© 


312 


© 


i 352 


© 


013 


13 


053 


© 


i 113 


© j | 153 


© 


213 


© 


253 


© 


313 


© 


1 353 


© 


014 


© 


054 


29 


114 


30 i | 154 


© 


214 


16 


254 


© 


314 


© 


j 354 


© 


015 


17 


055 


© 


115 


© ! 1 155 


© 


215 


© 


255 


® 


315 


© 


i 355 

1 


© 


016 


ie 


056 


© 


116 


© | j 156 


© 


216 


© 


256 


© 


316 


© 


l 356 


© 


017 


© 


057 


© | 


117 


52 i j 157 


© 


217 


© 


257 


© 


317 


© 


357 


© 


020 


© 


060 


© | 


120 


© ! ! 160 


42 


220 


© 


260 


45 


320 


49 


360 


© 


021 


© 


06: 


46 


121 


si ; i6i 


© 


221 


56 


261 


© 


321 


© 


361 


© 


022 


© 


062 


32 i 


122 


55 


162 


© 


222 


IE 


262 


© 


322 


© 


3S2 


© 


023 


14 


063 


© 1 


123 


© 


163 


© 


223 


© 


263 


© 


323 


36 


363 


© 


024 


© 


064 


33 | 


124 


35 


164 


© 


224 


39 


264 


© 


324 


© 


364 


20 


023 


19 


065 


© j 


125 


© 


165 


® 


225 


© 


265 


© 


325 


© 


365 


© 


026 


1 
21 


066 


© 


: 126 


© ! : 166 


© 


226 


© 


266 


© 


326 


© 


366 


© 


027 


© 


067 


© 


127 


© 


| 167 


© 


227 


© 


207 


© 


327 


© 


367 


© 


030 


© 


070 


34 


130 


37 


170 


© 


230 


38 


270 


© 


330 


© 


370 


© | 


031 


24 


071 


© 


131 


© 


171 


© 


231 


© 


271 


© 


331 


© 


371 


© 


032 


25 


072 


© 


132 


© 


172 


12 


232 


© 


272 


© 


332 


© 


372 


© 


033 


© 


073 


© 


133 


© 


173 


© 


233 


© 


273 


© 


333 


© 


373 


© 


034 


26 


074 


© 


134 


© 


174 


© 


234 


© 


274 


© 


334 


© 


374 


© 


03: 


© 


075 


4 


135 


© 


175 


© 


235 


© 


275 


© 


335 


© 


375 


© 


036 


© 


076 


© 


136 


© 


176 


© 


236 


© 


276 


© 


336 


© 


376 


© 


037 


© 


077 


© 


137 


© 


177 


© 


237 


© 


277 


© 


337 


© 


377 


© 



The 8 syndrome bits along with 6 address bits associated with the memory reference are sent to 
the status register. This information can then be interpreted to allow determination of failing 
CSU, memory bank, memory quadrant, and (in the case of single correctable errors) the failing 
bit. This information makes it possible for the maintenance engineer to isolate the failure to a 
module level. 



Double error or multiple double error (even no. of code bits set) 

Multiple error reported as single error (5 or 7 code bits set) 

Not used due to 64 -bit algorithm 

Syndrome codes above are octal representations of 8 syndrome code bits 

No error was detected 

Figure C-6. SECDED Syndrome Codes/Corrected Bits 
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54 
66 
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R 



R 
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Bit 1 



Loaded and 
Locked by Bit 77 



R 



Break 
Point 
Port 
Code 
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67 



R 



Parity 
Error 
Port 
Code 

Bit 
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4 
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2 
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53 


52 


51 


50 


49 


48 


65 


64 
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62 


61 
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_A„ 
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Loaded and 
Locked by Bit £> 



^ 

Loaded and 
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CMC .... Central Memory Control 
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60 
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R 
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R 


R 
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X 
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X 
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X 
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X 
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PPS 

p 

Register 
Bit 




O 

-J 

O 

o 

u 



bits 60 thru 71 display P register for the PP selected by bits 
120 thru 123 and bits 72 thru 75 display the PP selected. 

the contents of the P register is latched (i.e., locked) and 
retained on every CM breakpoint HIT. 

and bit 7G gets set, bits 60 thru 75 are held unit bit 76 is 

cleared. 
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83 


82 


81 


80 


79 
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C 


77 


76 


75 


74 


73 


72 


123 


122 
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117 


11 


115 


114 


113 


112 


111 


110 




C 




C 


C 


C 




S 


S 


S 


S 
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S 




D 




D 









X 






R 


R 


R 


R 


X 




X 


X 
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X 


X 


X 


PPS 
Break 
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Zero 
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Clear 
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Busy 
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Break 
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HIT 


3 


2 


1 


pp 

Code 

Bit 


















^ 
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Same comments as 










Loads and Locks 
bits 56 thru 59. 




Same comments as 
bits 60 thru 71. 




hit 60 thru 71. 








Busy FF If lip flop) ill PPS. 










One shop operation, i.e., set bit 79 set C5 full. This 








One shot operation, i.e.. set 










allows a PP hung on an unanswered CM request to react as 




bit 78 clears the interlock 










it 


C5 wen 


hill (received 


Jala from CMO 


and continue. 


— 1 






Central Memory 


Busy. 











This allows recovery from a lost accept signal on a PP 
to CM request. 
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Major 
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99 


98 
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96 
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Break 

Point 

Address 

Bit 



Absolute 18 bit address sent to CMC for Breakpoint condition. 

Bits 96 thru 1 1 3 are used by CMC for Breakpoint address when the 
condition code is set in bits 116 and 117. 

See Figure C-7. 
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108 


167 
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157 


156 


155 


154 




C 


C 


C 


C 


C 


C 


C 


C 


C 


C 


C 




















































X 














































Not 
Used 


Inhibit 
Single 
Error 
Report 


21 


20 


19 


Break 

Point 

Condition 

Code 

18 


17 


16 


15 


14 


13 


Break 

Point 

Address 

12 



See diagram (P. 2-15) 



Same comments as bits 96 through 107 



CO 
CD 



Single errors are not recorded {when detected) in SCR when this bit 1 18 is set. 



u 



BREAKPOINT CHECK FOR DIAGNOSTICS NOT CURRENTLY SUPPORTED BY NOS 

CMC performs a breakpoint check on reference to CM when breakpoint is selected. Breakpoint 
is selected from the status and control register in the PPS. 

CMC receives 18 breakpoint address bits, two port control bits, and two access control bits. 
Table C -1 lists the breakpoint control translations . 



TABLE C -1 . BREAKPOINT CONTROL TRANSLATION 



Control Bit 


Translation 


117 


116 


115 


114 




1 
1 

X 



1 

1 

X 

X 


X 

X 
X 
X 




X 

X 
X 
X 



1 


Breakpoint Check Disabled 
Breakpoint Check for PP Ports 
Breakpoint Check for CPU Ports 
Breakpoint Check for PP and CPU Ports 

Breakpoint Check on Read 

Breakpoint Check on Write j 

1 



X 
X 



X 
X 



Breakpoint Check on RNI 
Breakpoint Check on any access 



The 18 -bit address of each CM reference is compared to the breakpoint address bits . If there 
is a match and if the requesting unit is selected by the port control bits, and if the type of 
access is one that is selected by the access control bits, the breakpoint flag is sent to the 
requesting unit. 

The breakpoint flag is also sent to the status register along with the two port code bits and the 
two access code bits. 

When executing an exchange jump, this operation is treated by breakpoint as both a read and 
a write . A return jump is treated as a write . 

BREAKPOINT NOTES FOR MODEL 175 

1 _ Sinrp Hr^alrno'' nt i <s for an flHrlrogc; ronnoct tn, r*."\A » lirpalfnoiri' /Jnoc *■*•>+■ ^^-,^,-r. -P/^»- -, « 

instruction executed from the instruction stack if the instruction entered the instruc- 
tion stack before selecting breakpoint. 

2. The value of P plus RAC when the CPU is stopped by breakpoint may not correspond 
with the value of the breakpoint address because the CPU normally requests two words 
ahead of P on an RNI . 

3. The value of P plus RAC when the CPU stops for a breakpoint on an increment address 
may not correspond with the value of the P+RAC of the increment instruction. Advancing 
P is based on the 60 -bit word of instructions entering CIW instead of any given parcel 
of CIW being executed. 
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BIT IN WORD 
BIT DECIMAL 
BIT OCTAL 
S/C 

FUNCTION 
CHAN 36 
DISPLAY 

WORD 
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6 
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4 
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131 


130 


129 


128 


127 


126 


125 


124 


123 


122 


121 


120 


203 


202 


201 


200 


177 


176 


175 


174 


173 


172 


171 


170 






C 


C 


C 


C 


C 


C 


C 


C 


C 


C 










D 


D 


D 


D 


D 


D 


D 


D 










X 


X 


X 


X 


X 


X 


X 


X 


















X 


X 


X 


X 


























Not 
Used 


Not 
Used 


force 
Zero 
Address 
Parity 
CMC to 
CM 


Zero 
Data 
Code 
and 
Parity 
CMC to 
CM 


CSU 

CMC 

CPU 

Master 

Clear 


Force 

PP 
Dead 
Start 


Force 

Exit 

on 

Selected 

PP 


pp 

Select 
Auto/ 
Manual 
Mode 


3 


2 


1 


pp 

Select 
Code 

Bit 




! 


One sliot operation 
The selected PP will 
complete the current 
instruction and go 
on to the next without 
waiting for conditional 
replies. 


IV 
SI 


^ j 


I PP remains in DS condition 
Zero parity bit -I until the bit 126 

is cleared, i.e. hang on -— — 
input on its associated 
channel 


Select 1 of 10 PP's 
for forced 

EXIT bit 12S 
DEADSTART bit 126 
DISPLAY bit 124 

anual bits 72-75 display PP 
■lected by switches on chassis 



Auto bits 72-75 display PP 
selected by bits 120-123 



o 

-j 

o 
o 
O 
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BIT IN WORD 
BIT DECIMAL 
BIT OCTAL 
S/C 

FUNCTION 
CHAN 36 
DISPLAY 

WORD 




11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


l 





143 


142 


141 


140 


139 


138 


137 


136 


135 


134 


133 


132 


217 


216 


215 


214 


213 


212 


211 


210 


207 


206 


205 


204 


C 


C 


C 


S 


S 


S 


S 


S 


C 


C 


C 


C 




















































X 


X 








































c 
2 


lock Frequenc 
Margins 

1 


y 




ECS 

Transfer 

Error 


CMC 
Address 
Parity 
Error 
Type 


ECS 

2 


Error 

1 


Status 
Bit 




Refresh 

Fast 


Margins 
Slow 


ECS coupler 
Zero parity 

Code Code 
1 



Bits 141 thru 143 
are code bits for 
selecting clock 
margins for Master 
clock 



-A. 



Bits 139 and 140 
loaded and locked 
by Bit 6 



Memory Refresh 
Times 



Q 






o 

I 

fO 
4^ 
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BIT IN WORD 
BIT DECIMAL 
BIT OCTAL 
S/C 

FUNCTION 
CHAN 36 
DISPLAY 

WORD 
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10 


9 


8 


7 


/ 
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5 


4 


3 


2 
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155 


154 


153 


152 


151 


150 


149 


148 


147 


146 


145 


144 


233 


232 


231 


230 


227 


226 


225 


224 


223 


222 


221 


220 


C 


C 


C 


C 


S 


S 


S 


S 


S 


S 


S 


S 


























































X 


X 


X 


X 


X 


X 


X 


X 


























Sol 
All /One 
RVM 


>cl 

Hi/Lo 
RVM 


Clock Pulse 

Width 
Wide 1 Narrow 


RVM 

7 


Adc 

6 














5 


4 


3 


2 


1 


Bit 




v_ 



Indicates Module having Reference Voltage Margins 
(RVM) applied. 
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167 


166 


165 


164 


163 


162 


161 


160 


159 


158 


157 


156 


247 


246 


245 


244 


243 


242 


241 


240 


237 


236 


235 


234 


C 


C 


C 


C 


C 


C 


C 


C 


C 


C 


C 


C 
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Bits 176 and 183 
correspond to memory 
degrad switches on 
Figure C-7. 



_A_ 



Zero parity bit 
on Data or address 
specified by the PP 



15 



11 


10 


9 


8 


7 


6 


5 


4 
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2 


1 





179 


178 


177 


176 


175 


174 


173 


172 


171 


170 


169 


168 


263 


262 


261 


260 


257 


256 


255 


254 


253 


252 


251 


250 


C 


C 


C 


c 


C 


C 


C 


C 


C 


C 


C 


C 


































X 


X 






























































MEM 


RECOI* 


IFIGURATION 


BIT 


PPS TO CMC 
ZERO PARITY BIT 


RVM 


MODULE 


ADDRESS 






BIT 


3 


2 


1 





DATA 


ADRS 


5 


4 


3 


2 


1 
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BIT IN WORD 
BIT DECIMAL 
BIT OCTAL 
S/C 

FUNCTION 
CHAN 36 
DISPLAY 

WORD 




11 


10 


9 
189 


8 


7 


6 


191 


190 


188 


187 


186 


277 


276 


275 


274 


273 


272 






C 


C 


C 


C 


















X 


X 






























Not 
Used 


Not 
Used 


Soft 


ware 


Zero 


Lock 
Clear 


Lock 
Test 


CPU! 
to CMC 


CPU-0 
to CMC 







5 
185 



271 
C 



184 



270 



Parity 



CPU-1 
to CMC 



CPU 

to CMC 



^V_ 



Diagnostic 
Aids 



Zero parity bit on data or 
address 



183 



267 



X 



Double 
Error 
From 

CMC 



182 



266 



Indicates 
double 
error from 
SEC DEO. 
See bit 6 



181 



265 



180 



264 



Memory Configuration 



Same as comment 
on bits 176 179 



-J 
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Memory Range of Normal Operation I 
Size Address Adrs Ran^e jBad(oJuadj Bad 

Cpntrol Sw Code Sw Quadrant 



Degraded Operation 

~I Switches 



12 3 4 5 6 7 



262 K 



196 K 



131 K 



98 K 



65 K 



49 K 



32 K 



0-777777 



1111 



1 1.1 



CSU-0 



CSU-1 



0-577777 



1110 



1 1 1 



0-377777 



Oil! 



0-277777 110 



0-177777 



0-137777 



0-077777 



11111 



CSU-0 



CSU-1 



1 1 1 



10 



1 



1 1 1 



1 1 





1 

1 

1 1 



1 

1 


1 




1 



1110 



111 


















1 





1 








1 


1 


1 








1 





1 


1 


1 





1 


1 


1 

















1 





1 








1 


1 


1 








1 





1 



i 1 (J 



1 
1 
1 1 




10 
I 1 

NO DEGRADE 



Figure C-7. Memory Selection Scheme for Model 172/173/174 
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BIT IN WORD 
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FUNCTION 
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WORD 




11 


10 


9 


8 


7 




203 


202 


201 


200 


199 


19 


313 


312 


311 


310 


307 


30 






S 


S 


S 








R 


R 


R 








































Not 
Used , 


Not 
Used 


PPM 

4 


3 


2 


lecortfu] 





5 


4 


3 


2 


1 







197 


196 


195 


194 


193 


192 




305 


304 


303 


302 


301 


300 




S 


S 


S 


S 


S 


S 




R 


R 


R 


R 


R 


R 




















X 


X 


X 


X 


X 
















ioi 





Monitor 

Flag 
Status 

1 


Monitor 
Flag 
Status 




ECS 

m 

Progress 

Flag 


CPU-1 
Stopped 


CPUO 
Stopped 



Which physical PP is logically PPO. 
i.e. the PPO select switches from 
the DS panel 



.A. 



Indicate CPU 
status monitor 
or program 

mode 



Program stop 



o 



CPU EXIT MODE/ERROR RESPONSE 

Since memory, all channels, and ECS now have parity, the system needs to be able to take 
non -default action on parity conditions. In order to implement the non -default action, three 
bits have been added to the EM portion of the exchange package (EP) . 

Figure C-8 shows the EP 



159 56 53 50 4? 44 41 



CM 

locations' 



12 bits 



So EM is yOOx where y and x are exit mode errors 



" W////A 



35 



»+W sM 



W/M 



RAC 



N+2 

N+J j EM 
N + 4 
N+5 



FLC 



™ Y/////////////M 



FLE 



-zMB, 



m. 



N + 6 
N + 9 
N + 10 
N+l I 
N + 12 
N + 13 
N+14 
N + 15 



V////////////////////////////A 



A0 



A2 



A3 



A4 



A6 



A7 



xo 



X2 



X5 



X7 



mr/////////////////A 



Bl 



B£ 



B3 

B4 



B5 



B6 



B7 



W//X NO HARDWARE REGISTERS EXIST 



Figure C-8. Hardware Exchange Package 
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When the CPU detects or is informed of an error, it will record the error. Depending on the 
type of error and the mode selection bits , the program in execution may be interrupted , If the 
error is an illegal instruction, breakpoint, or address range errors on RNI or branch, the pro- 
gram interruption will be unconditional. For other types of errors, the mode selection bits 
determine whether or not the program will be interrupted. If the mode selection bit set and the 
corresponding condition is detected, the program will be interrupted. These sections are con- 
tained in word N+3 of the exchange package and are selected as follows: 



Address range error 

Infinite mode 

Indefinite mode 

Parity error on ECS 
flag register operation 

CMC input error 

CM data error 

Error conditions 43, 49, and 50 are detected in the CPU and conditions 51, 52, and 53 are 
flags sent to the CPU from the CMC . The data parity error flag indicates a transmission error 
(or memory error in default mode) on data sent to the CPU. The CMC input error flag indicates 
that the address or data sent by the CPU had incorrect parity at the CMC or CM . The double 
error flag indicates that the SECDED network detected a double error on data that was requested 
by the CPU . 

Any error condition detected after an exchange jump instruction has started execution is treated 
as an error for the program being exchanged in. Tables C-2 through C-4 explain what happens 
when the various kinds of errors occur. 

Each of these tables lists the same error conditions.. The error response is dependent on the 
setting of the MEJ/CEJ switch and the state of the monitor (MF) flag. The table headings 
specify the three combinations. 



Condition Bit 


Mode S 


election Bit 


48 




48 


49 




49 


50 




50 


51 




57 


52 




58 


53 




59 
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TABLE C-2. ERROR RESPONSE WITH MEJ/CEJ ENABLED, MF SET 



o 



d 



Error Condition 


Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


Illegal instruction 


1. Execute the illegal instruction 
as if it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Execute the illegal instruction 
as if it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


Exit condition bit 48 set by an increment 
read of an address out of range 


1. Read all zeros to the selected X 
register. 

2. Stop CPU. 

3. Store P and exit condition bits at RAC. 

4. Clear P. 


1. Read all zeros to the selected X 
register. 

2. Continue execution. 


Exit condition bit 48 set by an increment 
write of an address out of range. 


1. Block write operation, contents of 
CM is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at RAC. 

4. Clear P. 


1. Block write operation, contents of 
CM is unchanged. 

2. Continue execution. 


Exit condition bit 48 set on RNI or branch 
out of range 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 


Exit condition bit 48 set on CMU 
instruction 

a. CI or C2 > 9 

b. Kl or K2 address out of range 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction moves 
or compares up to the point of address 
out of range. 

2. Stop CPU. 

3. Store P and exit condition at RAC. 

4. Clear P. 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction 
moves or compares up to the point 
of address out of range. 

2. Continue with next 60-bit 
instruction. 



o 
o 
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TABLE C-2. ERROR RESPONSE WITH MEJ/CEJ ENABLED. MF SET (Continued) 



Error Condition 



Exit condition bit 48 set by an 
ECS address range check 



Infinite condition (bit 49) 
Indefinite condition (bit 50) 
ECS flag register parity (bit 51) 
CMC input error condition (bit 52) 
CM data error condition (bit 53) 



CMC input error condition (bit 52) 



00 instruction 



Breakpoint signal from CMC 
(refer to breakpoint notes) 



Error Response 



Exit Mode Selected 



1. Force ECS instruction to execute 
as a pass instruction. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 



1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 



1. Block write operation, contents of 
CM is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 



1. Stop CPU. 

2. Store P and exit condition bits 
at RAC. 

3. Clear P. 



1. Execute remaining parcels of 60-bit 
word currently executing. 

2. Stop CPU. 

3. Store P and exit condition bits 
at RAC. 

4. Clear P. 



Exit Mode Not Selected 



1. Force ECS instruction to execute 
as a pass instruction. 

2. Exit to next 60-bit word. 

3. Continue execution with next 60-bit 
word. 



1. Continue execution,, 



1. Block write operation, contents of 
CM is unchanged. 

2. Continue execution,, 



1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 



1. Execute remaining parcels of 60-bit 
word currently executing. 

2. Stop CPU. 

3. Store P and exit condition bits 
at RAC. 

4. Clear P. 



o 






TABLE C-3. ERROR RESPONSE WITH MEJ/CEJ ENABLED, MF CLEAR 



CD 
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Error Condition 


Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


Rlegal instruction 


1. Execute the illegal instruction 
as if it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set 

MF. 


1. Execute the illegal instruction 
as if it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits 
at RAC. 

4. Clear P. 

5. Exchange jump to MA and set 
MF. 


Exit condition bit 48 set by an incre- 
ment read of an address out of range 


1. Rend all zeros to the selected X 
register. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Read all zeros to the selected 
X register. 

2. Continue execution. 


Exit condition bit 48 set due to an incre- 
ment write of an address out of range 


1. Block write operation, contents of 
CM is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Block write operation, contents of 
CM is unchanged. 

2. Continue execution. 


Exit condition bit 48 set due to an RNI 
or branch address out of range 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 

4. Exchange jump to MA and set MF. 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 

4. Exchange jump to MA and set MF. 
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TABLE C-3. ERROR RESPONSE WITH MEJ/CEJ ENABLED, MF CLEAR (Continued) 
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Error Condition 


Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


Exit condition bit 48 set on CMU 
instruction 

a. CI or C2 > 9 

b. Kl or K2 address out of range 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction 
moves or compares up to the point 
of address out of range. 

2. Stop CPU. 

3. Store P and exit condition at RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction 
moves or compares up to the point 
of address out of range. 

2. Continue with next 60-bit 
instruction. 


Exit condition bit 48 set by an ECS 
address range check 


1. Force ECS instruction to execute as 
a pass instruction. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Force ECS instruction to execute as 
a pass instruction. 

2. Continue execution with next 
60-bit word. 


Infinite condition (bit 49) 
Indefinite condition (bit 50) 

CMC input error condition (bit 52) 
CM data error condition (bit 53) 


1. Stop CPU. 

2. Store P and exist condition bits 
at RAC. 

3. Clear P. 

4. Exchange jump to MA and set MF. 


1. Continue execution. 


CMC input error condition (bit 52) 


1. Block write operation, contents 
of CM is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Block write operation, contents 
of CM is unchanged. 



o 
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TABLE C-3. ERROR RESPONSE WITH MEJ/CEJ ENABLED, MF CLEAR (Continued) 



Error Condition 


Error Response Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


00 instruction 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 

4. Exchange jump to MA and set MF. 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 

4. Exchange jump to MA and set MF. 


Breakpoint signal from CMC (refer to 
breakpoint notes) 


1. Execute remaining parcels of 60- 
bit word currently executing. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 


1. Execute remaining parcels of 60- 
bit word currently executing. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 

5. Exchange jump to MA and set MF. 
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TABLE C-4. ERROR RESPONSE WITH MEJ/CEJ DISABLED 
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Error Condition 
Illegal instruction 


Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


1. Execute the illegal instruction as if 
it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Execute the illegal instruction as if 
it were a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


Exit condition bit 48 set by an incre- 
ment read of an address out of range 


1. Read all zeros to the selected X 
register. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Read all zeros to the selected X 
register. 

2. Continue execution. 


Exit condition bit 48 set by an incre- 
ment write of an address out of range 


1. Block write operation, contents of CM 
is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Block write operation, contents of 
CM is unchanged. 

2. Continue execution. 


Exit condition bit 48 set due to an RNI 
or branch address out of range 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 


1. Stop CPU. 


Exit condition bit 48 set on CMU 
instruction 

a. CI or C2 > 9 

b. Kl or K2 address out of range 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction 
moves or compares up to the point 
of address out of range. 

2. Stop CPU. 

3. Store P and exit condition at RAC. 

4. Clear P. 


1. Condition (a) causes instruction to 
execute as pass. 

Condition (b) causes instruction 
moves or compares up to the point 
of address out of range. 

2. Continue with next 60-bit 
instruction. 

- ...'. _ 
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TABLE C-4. ERROR RESPONSE WITH MEJ/CEJ DISABLED (Continued) 



Error Condition 


Error Response 


Exit Mode Selected 


Exit Mode Not Selected 


Exit condition bit 48 set by ECS 
address range check 


1. Force ECS instruction to execute as 
a pass. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Force ECS instruction to execute as 
a pass. 

2. Continue execution with next 60-bit 
word. 


Infinite condition (bit 49) 
Indefinite condition (bit 50) 
ECS flag register parity (bit 51) 
CMC input error condition (bit 52) 
CM data error condition (bit 53) 


1. Stop CPU. 

2. Store P and exit condition bits at 
RAC. 

3. Clear P. 


1. Continue execution. 


CMC input error condition (bit 52) 


1. Block write operation, contents of 
CM is unchanged. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Block write operation, contents of 
CM is unchanged. 

2. Continue execution. 


00 instruction 


1. Stop CPU. 


1. Stop CPU. 


Breakpoint signal from CMC (refer to 
breakpoint notes) 


1. Execute remaining parcels of 60- 
bit instruction word. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 


1. Execute remaining parcels of 60- 
bit instruction word. 

2. Stop CPU. 

3. Store P and exit condition bits at 
RAC. 

4. Clear P. 



o 
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Function Table Processor, 16-22 

General Flow DMP= Job Flow, 5-33 
General Job Flow, 5-1 
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Identification Word Parameters, 12-19 

Identify Special Request, 8-17 

IIF, 17-26 

KIT Flowchart, 14-13 
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Input Data File, 15-13 
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Input /Output Buffers, 13-34 
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Input Register - 1RO, 13-48 
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Job Creates, 5-6 
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Job Flow, 6-1 

Job Processing, 5-1 

Job Is Rolled In, 5-8 

Job Is Rolled Out, 5-7 

Job 1, 23-2 
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Job 2, 23-9 

JSW, 3-38 
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Load Request, 12-2 
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OP Response, 14-35 
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PLL, 4-10 
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Pool PPU Request, 3-20 

Pool Processor Memory Map, 4-2 
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PP MTR, 3-20 
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PPR Initialization, 4-4 

PPR Initialization Routine PRS, 24-8 
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Process Function, 8-12 
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RUT, 9-20 

Rollout File, 5-10 

Rollout File Format, 5-12 
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Rollout Scheduling, 5-14 
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RPV, 26- IT 
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Sample Main Loop, 19-5 
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SFP, 4-25 
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Special Function Processor, 4-22 
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Special Processing, 5-19 
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STIMULATOR, 15-1 
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Stimulator Input File, Example 2, 15-12 

Stimulator Requirements, 15-5 

Stimulators, 15-3 
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STS, 26-14 
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Subcontrol Points, 1-7 

Subcontro! Points, 3-28 

Subcontrol Point Exchange Package, 3-30 

Subsystem Configuration, 17-1 

Subsystem Operation, 17-8 

Subsystems, 5-19 

SUN - Search for User Number, 11-18 

System Call Block, 10-4 
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System CP Processing, 3-27 

System CP Program Mode, 3-21 

System C P Program Mode, 3-21 

System CP XJ (MA) to CPUMTR, 3-28 
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System I/O Mass Storage, 7-1 

System Philosophy, 5-10 
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System Sector Format, 7-17 
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Table and Buffer Pointers 14-12 

Table of Function Processors - TFCN, 8-6 

Task Library Directory, 14-24 

Table Linkage, 7-1 

Table of Queues Two-Word Entry 

Format, 13-23 
Table of Read Processors - TRDO, 8-6 
Table of Re-Entry Routine, 13-24 
Table Relationships, 13-25 
Table of Request Processors, 25-7 
Table of Write Processors - TWTO, 8-S 
TAEQ Table, 17-13 
7AEQ Table Format, 17-13 
Task Library Directory, 14-23 
TCS, 6-34 
IE LEX Auxiliary Routine, 13-42 



TELEX Calls to 1TA, 13-45 

TELEX Call Block. 10-6 

TELEX Cail Format, 10-6 

TELEX Initialization, 13-7 

TELEX Interactive Subsystem. 13-1 

TELEX1 Processing Modules, 13-10 

TELEX Remote Package, 13-2 

TELEX Routines. 13-26 

TELEX Stimulator, 15-4 

TELEX Stimulator Software Description, 

TELEX/TRANEX, 15-1 

TELEX1 Control Loop, 13-11 

TELEX1 Main Program, 13-9 

TELEX 1 Memory Map, 13-12 

TELEX2 Termination, 13-28 

Terminal Status Table, 14-18 

Terminal Table Entry Summary, 13-21 

Terminal I/O, 8-29 

Terminal I/O Routine - TIO, 8-28 

Terminal Status Table, 14-18 

Terminal Table, 13-16 

Terminal Table Entry Words, 13-16 

Three Useful Routines, 23-2 

Timed Scan Processor ?1, 3-34 

Time-Sharing Job Rollout File, 13-47 

Track Link Byte Format, 7-4 
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Transaction Word Table, 13-21 

TRANEX, 14-5 

TRANEX CP, 14-9 

TRANEX -CP Initialization and 

Termination, 14-10 
TRANEX Memory Map, 14-2S 
TRANEX - Run-Time Transaction 

Executive, 14-24 
TRANEX Stimulator, 15-14 
TRANEX-TELEX Relationship, 14-3 
TRANEX1 - Transaction Executive 

Initialization, 14-10 
TRANEX2 - Recovery/End Processing, 14 
Translate Control Statement, 6-36 
Translation Tables Overlays, 13-29 
TPANS*^* * t-.'"" 1 
TRANSIM\\lessages, 15-25 
TREO, 8-16 
TRRT Format, 13-24 
TRT Lengths, 7-3 
TRT Track Reservation Table, 2-28 
TSEM Monitor Function Parameters, 13-1 
TSEM Monitor Request Format, 13-14 
TT for CS1, 15-18 
TTY I/O Routine, 13-48 
TTY Job Initiation, 13-3 
TTY Job Initiation, 13-5 
TTY Job Interaction (Input), 13-8 
TTY Job Interaction - Input, 13-4 
TTY Job Interaction (Output), 13-6 
TTY Job Interaction - Output, 13-4 
TTY Operation. 13-1 
TTY" Mass Storage Data Flow, 13-3 
Typical Queue Priority Scheme, 5-15 
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Write Mode Processing Subroutines, 13-4 
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1AJ Interaction, 6-14 

1AJ Calls 1RI to Restore the Job, 5-32 
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1CJ Complete Job, 3-46 
1CJ Complete Job, 6-44 
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1EM-1ED Main Loop, 16-28 

1IO Core Layout, 17-15 

1LS Core Layout, 16-20 
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IRI Rollin Routine, 6-48 
1RO Rollout Job, 6-49 
1RO Rollout Routine, 6-45 
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1SJ Interaction, 6-4 

1SJ Job Scheduler, 6-1 

1S.J Main Program, 6-6 
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1SJ PRS, S-5 

1TA Control Loop, 13-44 

1TD Communicating with MUX, 15-2 
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3AB Process Error Flag, 5-25 ' 
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